3D
Obtener el estado del modelo 3D
Recupera el estado y el resultado de una tarea de generación 3D
GET /v1/3d/generations/{id} es un endpoint de compatibilidad. Se mantiene el soporte para integraciones existentes. Las nuevas integraciones deben consultar GET /v1/tasks/{id}; consulte Obtener estado de la tarea.
Llame a GET /v1/tasks/{id} para verificar el estado de su tarea de generación de modelos 3D.
id y task_id identifican la misma tarea.
Una tarea pública caducada o no disponible puede devolver 404 async_task_not_found. Si no se puede establecer la propiedad de la tarea para la API key actual, la respuesta será 403 task_not_owned.
Parámetros de ruta
El ID de la tarea de generación 3D.
Respuesta
Los campos que describen resultados, errores, marcas de tiempo y el modelo se devuelven cuando están disponibles para la tarea.
ID de la tarea.
Alias del identificador de tarea asíncrona cuando se proporciona.
URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con el id.
Estado de la tarea: pending, processing, completed, failed o timeout. Una tarea fallida sigue devolviendo HTTP 200.
Valor de progreso opcional. Se devuelve solo cuando hay un valor de progreso real disponible; utilice status para determinar la finalización.
URL para descargar el archivo del modelo 3D (cuando se completa). Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.
URL para descargar el modelo en formato GLB (cuando esté disponible).
URL para descargar el modelo en formato FBX (cuando esté disponible).
Mensaje de error (cuando falla).
Detalles del fallo cuando la tarea falla: status, message, type, code, retryable y param cuando un campo de la solicitud es el causante.
Estado de guardado de los enlaces de resultados: days e items[] con url, kind, status y expires_at. Puede estar ausente; los enlaces siguen funcionando. Consulte Retención de datos.
Solicitud
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Respuesta
{
"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"
}
]
}
}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
El ID de tarea asíncrona devuelto por id / task_id, o incrustado en poll_url
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json