Worlds
Obter Status do Mundo
Recupera o status e o resultado de uma tarefa de geração de mundo World Labs Marble
GET /v1/worlds/generations/{id} é um endpoint de compatibilidade. Ele permanece suportado para integrações existentes. Novas integrações devem consultar GET /v1/tasks/{id} com o mesmo id de tarefa; veja Obter Status da Tarefa.
Este endpoint retorna o status de uma tarefa de geração World Labs Marble. Use o id da tarefa obtido na resposta de criação.
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 de mundo e legendas são retornados quando disponíveis. Uma tarefa concluída não garante que todos os URLs de ativos estejam presentes. Uma tarefa com falha ainda retorna HTTP 200: leia status, error e error_details.
world_marble_url abre o visualizador interativo do World Labs. Arquivos de resultado como glb_url, pano_url e thumbnail_url são links TokenLab; eles ficam vazios ou ausentes até que a tarefa seja concluída.
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 para o mundo Marble gerado quando concluído.
Alias para o URL do mundo/modelo principal gerado.
URL GLB da malha de colisão quando disponível. Um link de resultado de mídia TokenLab que permanece válido por 30 dias.
URL da imagem panorâmica quando disponível. Um link de resultado de mídia TokenLab que permanece válido por 30 dias.
URL da imagem em miniatura quando disponível. Um link de resultado de mídia TokenLab que permanece válido por 30 dias.
Legenda para o mundo gerado.
Mensagem de erro quando a tarefa falha.
Detalhes da falha quando a tarefa falha: status, message, type, code, retryable e param quando um campo da requisição é a causa.
Status de salvamento dos links de resultado de mídia TokenLab em uma resposta concluída: days e items[] com url, kind, status e expires_at. Pode estar ausente; os links continuam funcionando. Veja Retenção de dados.
Requisição
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" } ] }}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