3D Render

3D rendering API reference. Generate high-quality images and turntable videos from 3D models. Multiple lighting presets, custom camera angles, up to 4K resolution.

Render Model

POST

/v1/tools/render/

Render any 3D model to a high quality image or turntable video. Supports multiple camera angles (front, back, left, right, top, 3/4 view, isometric), turntable animations (4, 8, or 12 frames rotating 360 degrees), three lighting presets, custom backgrounds, and optional ground shadows. Input supports GLB, OBJ, STL, PLY, FBX, and ZIP. Output is a PNG or WebP image, or an MP4, WebM, GIF, or PNG sequence video. Costs 5 credits for a single image, 20 credits for video or turntable renders.

Request

curl -X POST https://api.3daistudio.com/v1/tools/render/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/model.glb",
    "output_type": "image",
    "angle": "3/4",
    "resolution": 2048,
    "lighting": "studio",
    "background": "transparent",
    "ground_shadow": true
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

Camera Angles

Choose a preset camera angle for still renders, or use a turntable for a rotating view of the model.

Angle	Description
front	Straight on from the front of the model.
back	From behind the model.
left	From the left side.
right	From the right side.
top	Looking down from above.
3/4	Classic three quarter view (default). Great for showcasing the model.
isometric	Isometric projection angle.
turntable_4	360 degree rotation in 4 frames (90 degree steps).
turntable_8	360 degree rotation in 8 frames (45 degree steps).
turntable_12	360 degree rotation in 12 frames (30 degree steps).

Lighting Presets

Three lighting setups are available, each producing a different mood and style.

Preset	Description
studio	Three point lighting (key, fill, rim) with a dark background. Best for product shots.
outdoor	Natural sun lighting with a sky blue environment. Good for realistic outdoor scenes.
flat	Even, bright white lighting. Ideal for clean documentation or icon renders.

Parameters

Parameter	Type	Required	Description
model_url	string (URL)	Yes	URL of the 3D model. Supports GLB, OBJ, STL, PLY, FBX, and ZIP.
output_type	string	No	"image" or "video". Default: "image".
angle	string	No	Camera angle or turntable preset. Default: "3/4". See camera angles above.
resolution	integer	No	Render resolution in pixels (square). 512, 1024, 2048, or 4096. Default: 1024.
lighting	string	No	Lighting preset: "studio", "outdoor", or "flat". Default: "studio".
background	string	No	Background: "transparent", "white", "black", or a hex color like "#FF5500". Default: "transparent". Note: MP4 does not support transparency and will default to white.
ground_shadow	boolean	No	Add a shadow catcher plane beneath the model. Default: false.
format	string	No	Image format: "png" or "webp". Default: "png". Only used when output_type is "image".
video_format	string	No	Video format: "mp4", "webm", "gif", or "png_zip" (frame sequence as ZIP). Default: "mp4". Only used when output_type is "video".

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains the rendered image or video file. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": null,
      "asset": "https://storage.3daistudio.com/assets/render_3quarter.png",
      "asset_type": "3D_MODEL",
      "thumbnail": null
    }
  ]
}

Credit Costs

Output Type	Credits
Single image (any angle)	5
Video or turntable	20

Processing Times

Rendering a single image typically takes 30–50 seconds. Videos and turntable animations take 50–80 seconds depending on resolution and model complexity.