Consulta de tarefa

Consulte o status, o progresso e a saída de uma tarefa assíncrona Tripo por task_id.

Todos os endpoints de geração, processamento de malha, rigging, animação, importação de arquivo e conversão retornam um task_id. Use esse terminal para sondar até que a tarefa atinja success, failed ou cancelled.

Ponto final

HTTP

GET /v3/tasks/{task_id}

Parâmetros de caminho

Nome	Tipo	Obrigatório	Descrição
`task_id`	cadeia	obrigatório	Identificador de tarefa exclusivo retornado por um endpoint de criação de tarefa. Geralmente começa com `task_`.

Exemplo de solicitação

Bash

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123

Campos de resposta

Campo	Tipo	Descrição
`task_id`	cadeia	Identificador exclusivo da tarefa.
`type`	cadeia	Tipo de tarefa, como `text_to_model`, `image_to_model`, `rig` ou `convert`.
`status`	cadeia	Um de `queued`, `running`, `success`, `failed` ou `cancelled`.
`progress`	inteiro	Progresso da tarefa de `0` para `100`.
`output`	objeto	Preenchido quando `status=success`; pode incluir `model_url`, `rendered_image_url` ou outros ativos específicos de tarefas. Importar modelo e as tarefas de pós-processamento de modelo (rigging, texturização, conversão etc.) cuja entrada de modelo é um `file_token` ou URL também retornam `normalize_scale` (number): o fator de escala aplicado ao normalizar o modelo importado (`tamanho final = tamanho original × normalize_scale`; `1.0` significa sem redimensionamento).
`credits_consumed`	number	Créditos consumidos pela tarefa concluída.
`created_at`	cadeia	ISO 8601 hora de criação.
`completed_at`	cadeia	ISO 8601 tempo de conclusão quando disponível.

Tratamento de status

Trate queued e running como estados inacabados.
Baixe os ativos de saída somente após status=success.
Mostre failed ou cancelled ao usuário e evite repetir loops sem alterar a entrada.