3D

Obter Status do Modelo 3D

Recupera o status e o resultado de uma tarefa de geração 3D

GET
/v1/tasks/{id}

GET /v1/3d/generations/{id} é um endpoint de compatibilidade. Ele permanece suportado para integrações existentes. Novas integrações devem consultar GET /v1/tasks/{id}; veja Obter Status da Tarefa.

Chame GET /v1/tasks/{id} para verificar o status da sua tarefa de geração de modelo 3D.

id e task_id identificam a mesma tarefa.

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

O ID da tarefa de geração 3D.

Resposta

Campos que descrevem resultados, erros, timestamps e o modelo são retornados quando disponíveis para a tarefa.

idstring

ID da tarefa.

task_idstring

Alias do identificador da tarefa assíncrona quando fornecido.

poll_urlstring

URL de status para esta tarefa. Consulte GET /v1/tasks/{id} com o id.

statusstring

Status da tarefa: pending, processing, completed, failed ou timeout. Uma tarefa com falha ainda retorna HTTP 200.

progressinteger

Valor de progresso opcional. Retornado apenas quando um valor de progresso real está disponível; use status para determinar a conclusão.

model_urlstring

URL para baixar o arquivo do modelo 3D (quando concluído). Um link de resultado de mídia da TokenLab que permanece válido por 30 dias.

glb_urlstring

URL para baixar o modelo no formato GLB (quando disponível).

fbx_urlstring

URL para baixar o modelo no formato FBX (quando disponível).

errorstring | object

Mensagem de erro (quando houver falha).

error_detailsobject

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

media_retentionobject

Status de salvamento dos links de resultado: 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 "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Resposta

Resposta (Concluída)
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
  "glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
  "fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
  "media_retention": {
    "days": 30,
    "items": [
      {
        "url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
        "kind": "3d",
        "content_type": "model/gltf-binary",
        "status": "saved",
        "expires_at": "2024-02-22T08:54:20.000Z"
      },
      {
        "url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
        "kind": "3d",
        "content_type": "application/octet-stream",
        "status": "saved",
        "expires_at": "2024-02-22T08:54:20.000Z"
      }
    ]
  }
}

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

O ID da tarefa assíncrona retornado por id / task_id, ou incorporado na poll_url

Resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json