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.
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"
}'{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-11-19T12:00:00Z"
}Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| image | string | Conditional | — | Base64-encoded image (data:image/png;base64,...). PNG, JPEG or WebP. Required if image_url is not provided. |
| image_url | string | Conditional | — | URL to a publicly accessible image. Required if image is not provided. |
| output | string | No | "game" | Which mesh to return: "game" (game-ready mesh), "full" (full-resolution mesh) or "both". |
| pbr | boolean | No | false | Adds metallic and roughness maps to the game-ready mesh. Adds about 20 seconds. Ignored for output "full". |
| image_type | string | No | "synthetic" | "synthetic" for renders and generated images, "real" for photographs (looser crop around the object). |
| seed | integer | No | random | Random 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.
| output | Results | Mesh | Best For |
|---|---|---|---|
| game | 1 GLB | 30k triangles, UVs, base color + normal map (2048 px), 5–7 MB | Games, real-time, AR/VR, texturing and retopology tools |
| full | 1 GLB | 1–2M triangles with vertex colors, no texture maps, 25–55 MB | 3D printing, sculpting, remeshing |
| both | 2 GLBs | The game-ready mesh first, then the full-resolution mesh | Keeping 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.
curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"{
"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.
| Request | Credits |
|---|---|
| Any output, with or without PBR | 15 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.
| Status | Description |
|---|---|
| 400 | Missing or invalid parameters (e.g., no image, unsupported image format, invalid output). |
| 401 | Invalid or missing API key. |
| 402 | Insufficient credits. Purchase more credits. |
| 429 | Rate limit exceeded. Wait and retry. |
| 500 | Generation failed (for example, the image was flagged by content moderation). Credits are refunded automatically. |