Consulta de tarefa em lote

Consulte várias tarefas Tripo assíncronas em uma solicitação. Isso é útil quando seu aplicativo envia um lote de tarefas de geração ou processamento 3D e precisa atualizar seus estados juntos.

Ponto final

HTTP

POST /v3/tasks/list

Corpo da Solicitação

Campo	Tipo	Obrigatório	Descrição
`task_ids`	sequência[]	obrigatório	Tarefa IDs para consultar. Máximo de `100` IDs por solicitação.

Exemplo de solicitação

Bash

curl -s -X POST https://openapi.tripo3d.ai/v3/tasks/list \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":["task_abc123","task_def456"]}'

Campos de resposta

Campo	Tipo	Descrição
`tasks`	objeto	Mapa codificado por `task_id`. Cada valor usa a mesma estrutura da Consulta de Tarefa.
`missed`	sequência[]	Tarefa IDs que não foram encontradas, expiraram ou não estão acessíveis com o API Key atual.

Notas

Mantenha cada lote na tarefa 100 IDs.
Use missed para limpar tarefas obsoletas IDs do estado do seu aplicativo.
Para pesquisas de alto volume, recue quando todas as tarefas ainda estiverem queued ou running.