# Пакетный запрос задачи
Запрос нескольких асинхронных задач Tripo в одном запросе. Это полезно, когда ваше приложение отправляет пакет задач создания или обработки 3D-изображений и ему необходимо вместе обновить их состояния.
## Конечная точка
```http
POST /v3/tasks/list
```
## Тело запроса
| Поле | Тип | Требуется | Описание |
| --- | --- | --- | --- |
| `task_ids` | строка[] | требуется | Задача IDs для запроса. Максимальное количество `100` ID на запрос. |
Каждое значение должно быть UUID из ответа на создание задачи; один неверный ID отклоняет весь запрос с HTTP 400 / кодом `1004`.
## Пример запроса
UUID ниже приведены для примера. Замените их значениями `task_id` из ответов на создание ваших задач.
```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"]}'
```
## Поля ответа
| Поле | Тип | Описание |
| --- | --- | --- |
| `tasks` | объект | Карта с ключом `task_id`. Каждое значение использует ту же структуру, что и Task Query. |
| `missed` | string[] / null | Корректные ID задач, которые не найдены или недоступны с текущим ключом API. Если все запрошенные ID найдены, `missed` может быть `null` или отсутствовать. |
## Примечания
- Сохраняйте каждую партию под задачей `100` IDs.
- Перед удалением элемента из `missed` проверьте ID и аккаунт/ключ API.
- При большом объеме опроса отступите, когда все задачи по-прежнему имеют вид `queued` или `running`.
Пакетный запрос задачи
Запрос нескольких асинхронных задач Tripo в одном запросе. Это полезно, когда ваше приложение отправляет пакет задач создания или обработки 3D-изображений и ему необходимо вместе обновить их состояния.
Конечная точка
Тело запроса
| Поле |
Тип |
Требуется |
Описание |
task_ids |
строка[] |
требуется |
Задача IDs для запроса. Максимальное количество 100 ID на запрос. |
Каждое значение должно быть UUID из ответа на создание задачи; один неверный ID отклоняет весь запрос с HTTP 400 / кодом 1004.
Пример запроса
UUID ниже приведены для примера. Замените их значениями task_id из ответов на создание ваших задач.
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"]}'
Поля ответа
| Поле |
Тип |
Описание |
tasks |
объект |
Карта с ключом task_id. Каждое значение использует ту же структуру, что и Task Query. |
missed |
string[] / null |
Корректные ID задач, которые не найдены или недоступны с текущим ключом API. Если все запрошенные ID найдены, missed может быть null или отсутствовать. |
Примечания
- Сохраняйте каждую партию под задачей
100 IDs.
- Перед удалением элемента из
missed проверьте ID и аккаунт/ключ API.
- При большом объеме опроса отступите, когда все задачи по-прежнему имеют вид
queued или running.