Worlds

Obtener estado del mundo

Recupera el estado y el resultado de una tarea de generación de mundos de World Labs Marble

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id} es un endpoint de compatibilidad. Se mantiene el soporte para integraciones existentes. Las nuevas integraciones deben consultar GET /v1/tasks/{id} con el mismo id de tarea; consulte Obtener estado de la tarea.

Este endpoint devuelve el estado de una tarea de generación de World Labs Marble. Utilice el id de la tarea obtenido de la respuesta de creación.

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

ID de la tarea de generación del mundo.

Respuesta

Solo id y status son obligatorios en una respuesta de estado exitosa. Los alias de tarea, los IDs de operación, los activos del mundo y los subtítulos se devuelven cuando están disponibles. Una tarea completada no garantiza que todas las URLs de activos estén presentes. Una tarea fallida aún devuelve HTTP 200: lea status, error y error_details.

world_marble_url abre el visor interactivo de World Labs. Los archivos de resultado como glb_url, pano_url y thumbnail_url son enlaces de TokenLab; están vacíos o ausentes hasta que la tarea se completa.

idstring

ID de la tarea pública.

task_idstring

Alias del identificador de la tarea asíncrona.

operation_idstring

ID de operación de World Labs.

statusstring

Estado de la tarea: pending, processing, completed, failed o timeout.

world_idstring

ID del mundo de World Labs cuando se completa.

world_marble_urlstring

URL del mundo Marble generado cuando se completa.

model_urlstring

Alias para la URL principal del mundo/modelo generado.

glb_urlstring

URL del archivo GLB de la malla de colisión cuando está disponible. Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.

pano_urlstring

URL de la imagen panorámica cuando está disponible. Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.

thumbnail_urlstring

URL de la imagen en miniatura cuando está disponible. Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.

captionstring

Subtítulo para el mundo generado.

errorstring | object

Mensaje de error cuando la tarea 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 multimedia de TokenLab en una respuesta completada: days e items[] con url, kind, status y expires_at. Puede estar ausente; los enlaces siguen funcionando. Consulte Retención de datos.

Solicitud

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  },  "media_retention": {    "days": 0,    "items": [      {        "url": "http://example.com",        "kind": "image",        "content_type": "string",        "status": "saving",        "expires_at": "2019-08-24T14:15:22Z"      }    ]  }}

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

ID de la tarea de generación de mundo.

Respuesta

application/json

application/json

application/json