Worlds
Obter Status do Mundo
Recupera o status e o resultado de uma tarefa de geração de mundo do World Labs Marble
Consulte este endpoint para verificar o status de uma tarefa de geração do World Labs Marble. Se a resposta de criação incluiu poll_url, prefira chamar essa URL exata.
Uma tarefa pública expirada ou indisponível pode retornar 404 async_task_not_found. Se a propriedade da tarefa não puder ser estabelecida para a API key atual, a resposta será 403 task_not_owned.
Parâmetros de Caminho
ID da tarefa de geração de mundo.
Resposta
Apenas id e status são obrigatórios em uma resposta de status bem-sucedida. Aliases de tarefa, IDs de operação, ativos do mundo, legendas, custo e a string error são retornados quando disponíveis. Uma tarefa concluída não garante que todas as URLs de ativos estejam presentes.
ID da tarefa pública.
Alias do identificador da tarefa assíncrona.
ID da operação do World Labs.
Status da tarefa: pending, processing, completed, failed ou timeout.
ID do mundo do World Labs quando concluído.
URL do mundo Marble gerado quando concluído.
Alias para a URL principal do mundo/modelo gerado.
URL do GLB da malha de colisão (collider mesh) quando disponível.
URL da imagem panorâmica quando disponível.
URL da imagem em miniatura quando disponível.
Legenda para o mundo gerado.
Detalhes do custo de geração quando disponíveis, incluindo total_credits. Verifique seus registros de uso para o valor cobrado.
Mensagem de erro quando a tarefa falha.
Requisição
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" } }}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
ID da tarefa de geração de mundo.
Resposta
application/json
application/json
application/json