3D Generation | Overview
3D model generation API overview. Supports Hunyuan 3D Pro, Rapid, and TRELLIS.2 models. Text-to-3D and image-to-3D with GLB output and optional PBR textures.
Overview
The 3D Generation API lets you create 3D models from text descriptions or reference images. All generation is asynchronous. You submit a request, receive a task ID, and poll the status endpoint until the result is ready.
Available Providers
| Provider | Editions | Input | Output | Credits |
|---|---|---|---|---|
| Tencent Hunyuan 3D | Pro, Rapid | Text prompt, single image, or multi-view images | GLB, OBJ, STL, FBX (with optional PBR textures) | 35 to 100 per request |
| TRELLIS.2 | — | Single image (base64 or URL) | GLB (geometry only or with PBR textures) | 10 to 50 per request |
How It Works
All 3D generation follows the same async pattern. Submit your request, receive a task_id, then poll the status endpoint.
# 1. Submit a generation request
curl -X POST https://api.3daistudio.com/v1/3d-models/tencent/generate/rapid/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "a wooden chair", "enable_pbr": true}'
# 2. Poll for results
curl https://api.3daistudio.com/v1/generation-request/TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"Generation Status
GET/v1/generation-request/<task_id>/status/
Poll this endpoint to check the status of any generation request. When status is "FINISHED", the results array contains download URLs for your assets.
{
"status": "FINISHED",
"progress": 100,
"results": [
{
"asset_url": "https://cdn.3daistudio.com/models/abc123.glb",
"asset_type": "3D_MODEL",
"thumbnail": "https://cdn.3daistudio.com/thumbnails/abc123.png"
}
]
}Status Values
| Status | Description |
|---|---|
| PENDING | Request is queued and waiting to be processed. |
| IN_PROGRESS | Generation is currently running. |
| FINISHED | Generation complete. Results are available. |
| FAILED | Generation failed. Credits are refunded automatically. |
Need a Different Format?
All 3D generation endpoints output GLB files. Need OBJ, FBX, STL, or PLY instead? Use the Convert tool to transform your generated model into any supported format.