# 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. |
Cada valor deve ser um UUID retornado na criação da tarefa; um ID malformado rejeita toda a solicitação com HTTP 400 / código `1004`.
## Exemplo de solicitação
Os UUIDs abaixo são exemplos. Substitua-os pelos valores `task_id` retornados ao criar suas tarefas.
```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":["123e4567-e89b-42d3-a456-426614174000","123e4567-e89b-42d3-a456-426614174001"]}'
```
## 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` | string[] / null | IDs válidos de tarefas não encontradas ou inacessíveis com a chave API atual. Quando todos os IDs solicitados são encontrados, `missed` pode ser `null` ou estar ausente. |
## Notas
- Mantenha cada lote na tarefa `100` IDs.
- Verifique o ID e a conta/chave API antes de descartar um item de `missed`.
- Para pesquisas de alto volume, recue quando todas as tarefas ainda estiverem `queued` ou `running`.
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.
Cada valor deve ser um UUID retornado na criação da tarefa; um ID malformado rejeita toda a solicitação com HTTP 400 / código 1004.
Exemplo de solicitação
Os UUIDs abaixo são exemplos. Substitua-os pelos valores task_id retornados ao criar suas tarefas.
Mapa codificado por task_id. Cada valor usa a mesma estrutura da Consulta de Tarefa.
missed
string[] / null
IDs válidos de tarefas não encontradas ou inacessíveis com a chave API atual. Quando todos os IDs solicitados são encontrados, missed pode ser null ou estar ausente.
Notas
Mantenha cada lote na tarefa 100 IDs.
Verifique o ID e a conta/chave API antes de descartar um item de missed.
Para pesquisas de alto volume, recue quando todas as tarefas ainda estiverem queued ou running.