3D

Obtener el estado del modelo 3D

Recupera el estado y el resultado de una tarea de generación 3D

GET
/v1/tasks/{id}

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

idstringpathobligatorio

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.

idstring

ID de la tarea.

task_idstring

Alias del identificador de tarea asíncrona cuando se proporciona.

poll_urlstring

URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con el id.

statusstring

Estado de la tarea: pending, processing, completed, failed o timeout. Una tarea fallida sigue devolviendo HTTP 200.

progressinteger

Valor de progreso opcional. Se devuelve solo cuando hay un valor de progreso real disponible; utilice status para determinar la finalización.

model_urlstring

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.

glb_urlstring

URL para descargar el modelo en formato GLB (cuando esté disponible).

fbx_urlstring

URL para descargar el modelo en formato FBX (cuando esté disponible).

errorstring | object

Mensaje de error (cuando falla).

error_detailsobject

Detalles del fallo cuando la tarea falla: status, message, type, code, retryable y param cuando un campo de la solicitud es el causante.

media_retentionobject

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

Response (Completed)
{
  "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
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

id*string

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