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} 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
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.
ID de la tarea pública.
Alias del identificador de la tarea asíncrona.
ID de operación de World Labs.
Estado de la tarea: pending, processing, completed, failed o timeout.
ID del mundo de World Labs cuando se completa.
URL del mundo Marble generado cuando se completa.
Alias para la URL principal del mundo/modelo generado.
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.
URL de la imagen panorámica cuando está disponible. Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.
URL de la imagen en miniatura cuando está disponible. Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.
Subtítulo para el mundo generado.
Mensaje de error cuando la tarea 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 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 Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
ID de la tarea de generación de mundo.
Respuesta
application/json
application/json
application/json