# Consulta de tareas por lotes
Consulta múltiples tareas asincrónicas Tripo en una sola solicitud. Esto es útil cuando su aplicación envía un lote de tareas de procesamiento o generación 3D y necesita actualizar sus estados juntos.
## Punto final
```http
POST /v3/tasks/list
```
## Cuerpo de solicitud
| campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `task_ids` | cadena [] | requerido | Tarea IDs para consultar. Máximo de `100` ID por solicitud. |
Cada valor debe ser el UUID devuelto al crear una tarea; un ID mal formado rechaza toda la solicitud con HTTP 400 / código `1004`.
## Ejemplo de solicitud
Los UUID siguientes son ejemplos. Sustitúyalos por los valores `task_id` devueltos al crear sus tareas.
```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 respuesta
| campo | Tipo | Descripción |
| --- | --- | --- |
| `tasks` | objeto | Mapa codificado por `task_id`. Cada valor utiliza la misma estructura que la consulta de tarea. |
| `missed` | string[] / null | IDs válidos de tareas que no se encontraron o no son accesibles con la clave API actual. Si se encuentran todos los IDs solicitados, `missed` puede ser `null` o estar ausente. |
## Notas
- Mantenga cada lote en la tarea `100` IDs.
- Compruebe el ID y la cuenta o clave API antes de descartar una entrada de `missed`.
- Para sondeos de gran volumen, retroceda cuando todas las tareas aún estén en `queued` o `running`.
Consulta de tareas por lotes
Consulta múltiples tareas asincrónicas Tripo en una sola solicitud. Esto es útil cuando su aplicación envía un lote de tareas de procesamiento o generación 3D y necesita actualizar sus estados juntos.
Punto final
HTTP
POST /v3/tasks/list
Cuerpo de solicitud
campo
Tipo
Requerido
Descripción
task_ids
cadena []
requerido
Tarea IDs para consultar. Máximo de 100 ID por solicitud.
Cada valor debe ser el UUID devuelto al crear una tarea; un ID mal formado rechaza toda la solicitud con HTTP 400 / código 1004.
Ejemplo de solicitud
Los UUID siguientes son ejemplos. Sustitúyalos por los valores task_id devueltos al crear sus tareas.
Mapa codificado por task_id. Cada valor utiliza la misma estructura que la consulta de tarea.
missed
string[] / null
IDs válidos de tareas que no se encontraron o no son accesibles con la clave API actual. Si se encuentran todos los IDs solicitados, missed puede ser null o estar ausente.
Notas
Mantenga cada lote en la tarea 100 IDs.
Compruebe el ID y la cuenta o clave API antes de descartar una entrada de missed.
Para sondeos de gran volumen, retroceda cuando todas las tareas aún estén en queued o running.