Queue

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

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

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

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

Path parameters

request_idstring uuid required

Example:764cabcf-b745-4b3e-ae38-1200304cf45b

Идентификатор запроса генерации, полученный при submit.

Response

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

request_idstring uuid required

Идентификатор запроса генерации.

status'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELED' required

Статус генерации в очереди. CANCELED — терминальный: генерацию можно отменить вне публичного API (например, из веб-интерфейса Clipia); cancel-эндпоинта в публичном API нет, но status может вернуть CANCELED, поэтому клиент обязан считать его финальным.

queue_positioninteger nullable

Позиция в очереди (для IN_QUEUE), иначе null.

progressinteger

Прогресс выполнения 0..100 (для IN_PROGRESS).

Example response

{
  "warnings": [
    {
      "code": "unsupported_parameter",
      "parameter": "duration",
      "message": "Parameter \"duration\" is not supported by model \"nano-banana-2\" and was ignored. Parameters declared by this model: aspect_ratio, prompt, resolution. Full schema: GET /v1/models/nano-banana-2."
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.