# Запрос задачи
Запросите состояние, ход выполнения и выходные данные одной асинхронной задачи Tripo с помощью `task_id`.
Все конечные точки генерации, обработки сетки, риггинга, анимации, импорта файлов и преобразования возвращают `task_id`. Используйте эту конечную точку для опроса, пока задача не достигнет `success`, `failed` или `cancelled`.
## Конечная точка
```http
GET /v3/tasks/{task_id}
```
## Параметры пути
| Имя | Тип | Требуется | Описание |
| --- | --- | --- | --- |
| `task_id` | строка | требуется | Уникальный идентификатор задачи, возвращаемый конечной точкой создания задачи. Обычно начинается с `task_`. |
## Пример запроса
```bash
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
https://openapi.tripo3d.ai/v3/tasks/task_abc123
```
## Поля ответа
| Поле | Тип | Описание |
| --- | --- | --- |
| `task_id` | строка | Уникальный идентификатор задачи. |
| `type` | строка | Тип задачи, например `text_to_model`, `image_to_model`, `rig` или `convert`. |
| `status` | строка | Один из `queued`, `running`, `success`, `failed` или `cancelled`. |
| `progress` | целое число | Ход выполнения задачи от `0` до `100`. |
| `output` | объект | Заполняется, когда `status=success`; может включать `model_url`, `rendered_image_url` или другие ресурсы для конкретных задач. Импорт модели, а также задачи постобработки модели (риггинг, текстурирование, конвертация и т. д.), у которых входная модель задана как `file_token` или URL, дополнительно возвращают `normalize_scale` (number): коэффициент масштабирования, применённый при нормализации импортированной модели (`итоговый размер = исходный размер × normalize_scale`; `1.0` — без масштабирования). |
| `credits_consumed` | number | Кредиты, потраченные на выполненное задание. |
| `created_at` | строка | ISO 8601 время создания. |
| `completed_at` | строка | ISO 8601 Время завершения, если доступно. |
## Обработка статуса
- Считайте `queued` и `running` незавершенными состояниями.
- Загружайте выходные ресурсы только после `status=success`.
- Покажите пользователю `failed` или `cancelled` и избегайте циклов повторных попыток без изменения ввода.
Запрос задачи
Запросите состояние, ход выполнения и выходные данные одной асинхронной задачи Tripo с помощью task_id.
Все конечные точки генерации, обработки сетки, риггинга, анимации, импорта файлов и преобразования возвращают task_id. Используйте эту конечную точку для опроса, пока задача не достигнет success, failed или cancelled.
Конечная точка
Параметры пути
| Имя |
Тип |
Требуется |
Описание |
task_id |
строка |
требуется |
Уникальный идентификатор задачи, возвращаемый конечной точкой создания задачи. Обычно начинается с task_. |
Пример запроса
curl -s \
-H "Authorization: Bearer YOUR_API_KEY" \
https://openapi.tripo3d.ai/v3/tasks/task_abc123
Поля ответа
| Поле |
Тип |
Описание |
task_id |
строка |
Уникальный идентификатор задачи. |
type |
строка |
Тип задачи, например text_to_model, image_to_model, rig или convert. |
status |
строка |
Один из queued, running, success, failed или cancelled. |
progress |
целое число |
Ход выполнения задачи от 0 до 100. |
output |
объект |
Заполняется, когда status=success; может включать model_url, rendered_image_url или другие ресурсы для конкретных задач. Импорт модели, а также задачи постобработки модели (риггинг, текстурирование, конвертация и т. д.), у которых входная модель задана как file_token или URL, дополнительно возвращают normalize_scale (number): коэффициент масштабирования, применённый при нормализации импортированной модели (итоговый размер = исходный размер × normalize_scale; 1.0 — без масштабирования). |
credits_consumed |
number |
Кредиты, потраченные на выполненное задание. |
created_at |
строка |
ISO 8601 время создания. |
completed_at |
строка |
ISO 8601 Время завершения, если доступно. |
Обработка статуса
- Считайте
queued и running незавершенными состояниями.
- Загружайте выходные ресурсы только после
status=success.
- Покажите пользователю
failed или cancelled и избегайте циклов повторных попыток без изменения ввода.
