3D
Get 3D Model Status
Retrieves the status and result of a 3D generation task
Poll this endpoint to check the status of your 3D model generation task.
If the create response includes poll_url, call that URL directly. id and task_id identify the same task; you can also use /v1/tasks/{id}.
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.
Preferred polling URL when the create response supplies one.
Task status: pending, processing, completed, or failed.
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).
URL to download the GLB format model (when available).
URL to download the FBX format model (when available).
Error message (when failed).
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://cdn.example.com/3d/abc123.glb",
"glb_url": "https://cdn.example.com/3d/abc123.glb",
"fbx_url": "https://cdn.example.com/3d/abc123.fbx"
}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