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}

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

idstringpathobrigatório

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.

idstring

ID da tarefa pública.

task_idstring

Alias do identificador da tarefa assíncrona.

operation_idstring

ID da operação do World Labs.

statusstring

Status da tarefa: pending, processing, completed, failed ou timeout.

world_idstring

ID do mundo do World Labs quando concluído.

world_marble_urlstring

URL para o mundo Marble gerado quando concluído.

model_urlstring

Alias para o URL do mundo/modelo principal gerado.

glb_urlstring

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.

pano_urlstring

URL da imagem panorâmica quando disponível. Um link de resultado de mídia TokenLab que permanece válido por 30 dias.

thumbnail_urlstring

URL da imagem em miniatura quando disponível. Um link de resultado de mídia TokenLab que permanece válido por 30 dias.

captionstring

Legenda para o mundo gerado.

errorstring | object

Mensagem de erro quando a tarefa falha.

error_detailsobject

Detalhes da falha quando a tarefa falha: status, message, type, code, retryable e param quando um campo da requisição é a causa.

media_retentionobject

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
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

id*string

ID da tarefa de geração de mundo.

Resposta

application/json

application/json

application/json