Worlds
Obtener estado del mundo
Recupera el estado y el resultado de una tarea de generación de mundos de World Labs Marble
Realice consultas a este endpoint para verificar el estado de una tarea de generación de World Labs Marble. Si la respuesta de creación incluyó poll_url, prefiera llamar a esa URL exacta.
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 de mundos.
Respuesta
Solo id y status son obligatorios en una respuesta de estado exitosa. Los alias de tarea, IDs de operación, activos del mundo, subtítulos, costo y la cadena error se devuelven cuando están disponibles. Una tarea completada no garantiza que todas las URLs de los activos estén presentes.
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.
URL de la imagen panorámica cuando está disponible.
URL de la imagen en miniatura cuando está disponible.
Subtítulo para el mundo generado.
Detalles del costo de generación cuando están disponibles, incluyendo total_credits. Consulte sus registros de uso para ver el monto facturado.
Mensaje de error cuando la tarea ha fallado.
Solicitud
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/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", "cost": {}, "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" } }}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