---
title: "Статус запроса"
method: GET
path: "/v1/requests/{request_id}/status"
tags: ["Queue"]
---

# Статус запроса

`GET /v1/requests/{request_id}/status`

## Request

- Base URL: `https://api.clipia.ai`
- URL: `https://api.clipia.ai/v1/requests/{request_id}/status`
- Auth: API key in header `Authorization`

Возвращает текущий статус генерации, позицию в очереди и прогресс.
Доступно любому валидному ключу (scope не требуется).

Если при исполнении сервер отступил от параметров запроса (например,
создаёт ролик без звука), ответ содержит массив `warnings` — см. схему
`RequestWarnings`.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

Текущий статус запроса.

- StatusResponse
  - `request_id` string, uuid, required: Идентификатор запроса генерации.
  - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELED', required: Статус генерации в очереди. `CANCELED` — терминальный: генерацию можно отменить вне публичного API (например, из веб-интерфейса Clipia); cancel-эндпоинта в публичном API нет, но `status` может вернуть `CANCELED`, поэтому клиент обязан считать его финальным.
  - `queue_position` integer, nullable: Позиция в очереди (для `IN_QUEUE`), иначе `null`.
  - `progress` integer: Прогресс выполнения 0..100 (для `IN_PROGRESS`).
  - `warnings` InputWarning[]: Предупреждения о ходе исполнения запроса: сервер отступил от параметров `input`, чтобы запрос завершился. Сейчас причина одна — `audio_dropped` (ролик создаётся без звука). Поле присутствует, только когда есть о чём предупредить, и не приходит при `FAILED` и `CANCELED`. На приёме запроса эти предупреждения ещё неизвестны, поэтому в ответе на создание их нет.
    - `code` string, required: Машинная причина: - `unknown_parameter` — ключ серверу неизвестен (например, опечатка) и отбрасывается у любой модели; - `unsupported_parameter` — ключ существует, но эта модель его не объявляет и не использует; - `audio_dropped` — звук был включён, но звуковая дорожка не прошла проверку безопасности модели: ролик создаётся без звука, стоимость запроса не меняется. Приходит только в ответах о состоянии запроса (`RequestWarnings`), `parameter` равен `generate_audio`. Список причин может пополняться: незнакомое значение обрабатывайте как «параметр не применён».
    - `parameter` string, required: Имя ключа из `input` (длинное имя обрезается до 64 символов).
    - `message` string, required: Пояснение на английском: называет параметр и перечисляет параметры, которые модель объявляет в `input_schema`. Для `audio_dropped` — сообщает, что ролик создаётся без звука.

## Other responses

- `401`: Ключ отсутствует, неверный или отозван.
- `404`: Неизвестный `request_id` или `model`.
- `429`: Превышен лимит. `error.type` всегда `rate_limit_error`; различайте по `error.code`: - `rate_limit_exceeded` — запросов в минуту (RPM) или токенов в минуту (TPM) по ключу; - `concurrency_limit_exceeded` — слишком много генераций одновременно (по ключу или по аккаунту). Дождитесь завершения одной и повторите. В обоих случаях сервер отдаёт заголовок `Retry-After` и дублирует подсказку в `error.retry_after_seconds`.

---

[API](https://skmtc.dev/clipia/apis/clipia-api.md) · [All operations](https://skmtc.dev/clipia/apis/clipia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipia/apis/clipia-api/revisions/cc55924a3381?raw)