Запрос задачи

Запросите состояние, ход выполнения и выходные данные одной асинхронной задачи Tripo с помощью task_id.

Все конечные точки генерации, обработки сетки, риггинга, анимации, импорта файлов и преобразования возвращают task_id. Используйте эту конечную точку для опроса, пока задача не достигнет success, failed или cancelled.

Конечная точка

HTTP

GET /v3/tasks/{task_id}

Параметры пути

Имя	Тип	Требуется	Описание
`task_id`	строка	требуется	Уникальный идентификатор задачи, возвращаемый конечной точкой создания задачи. Обычно начинается с `task_`.

Пример запроса

Bash

-cmd">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` или другие ресурсы для конкретных задач.
`credits_consumed`	целое число	Кредиты, потраченные на выполненное задание.
`created_at`	строка	ISO 8601 время создания.
`completed_at`	строка	ISO 8601 Время завершения, если доступно.

Обработка статуса

Считайте queued и running незавершенными состояниями.
Загружайте выходные ресурсы только после status=success.
Покажите пользователю failed или cancelled и избегайте циклов повторных попыток без изменения ввода.