3D
获取 3D 模型状态
获取 3D 生成任务的状态和结果
使用创建响应中的任务 ID 查询进度和结果。
创建响应带有 poll_url 时，优先使用该 URL。id 和 task_id 标识同一任务，也可以调用 /v1/tasks/{id}。
已过期或不可用的公开任务可能返回 404 async_task_not_found。无法确认当前 API 密钥对任务的归属权限时，返回 403 task_not_owned。
路径参数
idstringpath必填
3D 生成任务 ID。
响应
结果、错误、时间戳和模型字段仅在任务提供时返回。
idstring
任务 ID。
task_idstring
返回时与 id 对应的同一异步任务标识。
poll_urlstring
返回时优先使用的任务轮询 URL。
statusstring
任务状态：pending、processing、completed 或 failed。
progressinteger
可选进度值。仅在任务提供真实进度时返回；请使用 status 判断任务是否完成。
model_urlstring
3D 模型文件的下载 URL（完成时）。
glb_urlstring
GLB 格式模型的下载 URL（可用时）。
fbx_urlstring
FBX 格式模型的下载 URL（可用时）。
errorstring | object
错误信息（失败时）。
请求
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"响应
{
"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"
}授权
BearerAuth AuthorizationBearer <token>
API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
路径参数
id*string
由 id / task_id 返回或嵌入在 poll_url 中的异步任务 ID
响应
application/json
application/json
application/json
application/json