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

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

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

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