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.

Ejemplo de solicitud

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 respuesta

campo	Tipo	Descripción
`tasks`	objeto	Mapa codificado por `task_id`. Cada valor utiliza la misma estructura que la consulta de tarea.
`missed`	cadena []	Tarea ID que no se encontraron, caducaron o no fueron accesibles con el API Key actual.

Notas

Mantenga cada lote en la tarea 100 IDs.
Utilice missed para limpiar las tareas obsoletas ID del estado de su aplicación.
Para sondeos de gran volumen, retroceda cuando todas las tareas aún estén en queued o running.