Create 3D Generation
Generate a 3D model (GLB) from one or more input images.
Async mode (recommended): Returns 202 with a task ID immediately.
Poll GET /tasks/{taskId} for results.
Sync mode: Blocks for up to 55 seconds. If the task completes in time, returns the result directly. If still running, returns the task ID for polling.
Credits are deducted immediately. On failure, credits are automatically refunded.
Authorization
BearerAuth
API key with tr_ prefix, sent as Bearer token
In: header
Request Body
application/json
Single image URL (for image-to-3d models)
uriMultiple image URLs (2-4) — only for models with multi-view capability
2 <= items <= 4Text prompt (required for text-to-3d models like tripo-text)
length <= 2000Public model alias
"trellis2" | "trellis2-multiview" | "tripo" | "tripo-multiview" | "hunyuan3d" | "tripo-text"sync waits up to 55s; async returns immediately
"async""sync" | "async"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://trellis2.app/api/v1/3d/generations" \ -H "Content-Type: application/json" \ -d '{ "image_url": "https://example.com/chair.jpg", "model": "trellis2", "mode": "async" }'{
"id": "task_abc123",
"object": "3d.generation",
"status": "completed",
"created": 1723000000,
"completed_at": 1723000060,
"data": {
"model_url": "https://r2.example.com/model.glb",
"format": "glb",
"model": "trellis2"
},
"usage": {
"credits_consumed": 10,
"credits_remaining": 990
}
}{
"id": "task_abc123",
"object": "task",
"status": "pending",
"created": 1723000000,
"data": null
}{
"error": {
"message": "string",
"type": "string",
"code": "string",
"param": "string"
}
}{
"error": {
"message": "string",
"type": "string",
"code": "string",
"param": "string"
}
}{
"error": {
"message": "string",
"type": "string",
"code": "string",
"param": "string"
}
}{
"error": {
"message": "string",
"type": "string",
"code": "string",
"param": "string"
}
}