Idol Turbo

3D AI Studio

Idol Turbo

Generate a game-ready 3D model from a single image in about 20 seconds with Idol Turbo.

Generate 3D Model

POST

/v1/3d-models/idol/turbo/image-to-3d/

Turns one image of a single object into a GLB in about 20 seconds - the fastest 3D model in the API. By default you get a game-ready mesh: 30,000 triangles with UVs, a base color texture and a normal map. Generation is asynchronous: submit a request, receive a task ID, and poll for the result.

Request
curl -X POST https://api.3daistudio.com/v1/3d-models/idol/turbo/image-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/my-object.png"
  }'
Response
{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-11-19T12:00:00Z"
}

Parameters

ParameterTypeRequiredDefaultDescription
imagestringConditional—Base64-encoded image (data:image/png;base64,...). PNG, JPEG or WebP. Required if image_url is not provided.
image_urlstringConditional—URL to a publicly accessible image. Required if image is not provided.
outputstringNo"game"Which mesh to return: "game" (game-ready mesh), "full" (full-resolution mesh) or "both".
pbrbooleanNofalseAdds metallic and roughness maps to the game-ready mesh. Adds about 20 seconds. Ignored for output "full".
image_typestringNo"synthetic""synthetic" for renders and generated images, "real" for photographs (looser crop around the object).
seedintegerNorandomRandom seed (0–2147483647) for reproducible results.

Output Options

Every generation produces both meshes; output decides which ones are returned. The price is the same for all three options.

outputResultsMeshBest For
game1 GLB30k triangles, UVs, base color + normal map (2048 px), 5–7 MBGames, real-time, AR/VR, texturing and retopology tools
full1 GLB1–2M triangles with vertex colors, no texture maps, 25–55 MB3D printing, sculpting, remeshing
both2 GLBsThe game-ready mesh first, then the full-resolution meshKeeping both versions

Checking Status

GET

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

Poll this endpoint with the task_id from the generation response. Because Idol Turbo usually finishes in 15–30 seconds, poll every 1–2 seconds. When status is "FINISHED", the results array contains your model. Each result's metadata.mesh says which mesh it is: "game" or "full". With output "both", the game-ready mesh comes first; if the full-resolution mesh could not be stored, only the game-ready mesh is returned. 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,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/abc123.glb",
      "asset_type": "3D_MODEL",
      "metadata": { "mesh": "game" }
    }
  ]
}

Credit Costs

Credits are deducted when you submit a request. If generation fails, credits are refunded automatically.

RequestCredits
Any output, with or without PBR15 credits

Processing Times

Most requests finish in 15–30 seconds; PBR adds about 20 seconds. At busy times a request can wait in the queue for a free GPU before it starts, which adds to the total.

Errors

Common errors for Idol Turbo generation.

StatusDescription
400Missing or invalid parameters (e.g., no image, unsupported image format, invalid output).
401Invalid or missing API key.
402Insufficient credits. Purchase more credits.
429Rate limit exceeded. Wait and retry.
500Generation failed (for example, the image was flagged by content moderation). Credits are refunded automatically.