3D
Get 3D Model Status
Retrieves the status and result of a 3D generation task
GET /v1/3d/generations/{id} is a compatibility endpoint. It remains supported for existing integrations. New integrations poll GET /v1/tasks/{id}; see Get Task Status.
Call GET /v1/tasks/{id} to check the status of your 3D model generation task.
id and task_id identify the same task.
An expired or unavailable public task can return 404 async_task_not_found. If task ownership cannot be established for the current API key, the response is 403 task_not_owned.
Path Parameters
The 3D generation task ID.
Response
Fields describing results, errors, timestamps, and the model are returned when available for the task.
Task ID.
Async task identifier alias when provided.
Status URL for this task. Poll GET /v1/tasks/{id} with id.
Task status: pending, processing, completed, failed, or timeout. A failed task still returns HTTP 200.
Optional progress value. Returned only when a real progress value is available; use status to determine completion.
URL to download the 3D model file (when completed). A TokenLab media-result link that stays valid for 30 days.
URL to download the GLB format model (when available).
URL to download the FBX format model (when available).
Error message (when failed).
Failure details when the task failed: status, message, type, code, retryable, and param when a request field is at fault.
Saving status of the result links: days and items[] with url, kind, status, and expires_at. It can be absent; the links still work. See Data retention.
Request
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Response
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}Authorization
BearerAuth API Key authentication. Create or manage API keys in Dashboard > API > API Keys.
In: header
Path Parameters
The async task ID returned by id / task_id, or embedded in poll_url
Response
application/json
application/json
application/json
application/json
application/json
application/json
application/json