# 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`.