---
title: Статус запроса
description: "GET /v1/requests/{request_id}/status — узнать статус генерации."
---

Проверьте статус ранее поставленной генерации по её request_id.

## Песочница

<ApiPlayground path="/v1/requests/{request_id}/status" method="get" />

`GET /v1/requests/:id/status` возвращает текущий статус генерации, позицию в очереди и прогресс выполнения. Эндпоинт доступен любому валидному ключу — scope не требуется.

<Method name="GET" path="/v1/requests/:id/status" />

## Запрос

<TypeTable
  type={{
    id: { type: 'string', description: 'Идентификатор запроса (request_id, uuid), полученный при submit.', required: true }
  }}
/>

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl https://api.clipia.ai/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b/status \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

</Tab>
<Tab value="TypeScript">

```ts
const status = await clipia.queue.status('764cabcf-b745-4b3e-ae38-1200304cf45b');
console.log(status.status, status.progress);
```

</Tab>
<Tab value="Python">

```python
status = client.status("764cabcf-b745-4b3e-ae38-1200304cf45b")
print(status.status, status.progress)
```

</Tab>
</Tabs>

**Ответ `200`**

```json
{
  "request_id": "764cabcf-b745-4b3e-ae38-1200304cf45b",
  "status": "IN_PROGRESS",
  "queue_position": null,
  "progress": 45,
  "logs": []
}
```

<TypeTable
  type={{
    request_id: { type: 'string', description: 'Идентификатор запроса генерации (uuid)' },
    status: { type: 'string', description: 'IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED или CANCELED' },
    queue_position: { type: 'integer | null', description: 'Позиция в очереди для IN_QUEUE, иначе null' },
    progress: { type: 'integer', description: 'Прогресс выполнения 0–100 (для IN_PROGRESS)' },
    logs: { type: 'string[]', description: 'Логи выполнения, если запрошены' }
  }}
/>

## Получение результата

Тот же запрос без суффикса `/status` — `GET /v1/requests/:id` — возвращает финальный результат с полем `output`, когда статус терминальный, либо `202` пока генерация ещё в очереди или выполняется.

```bash
curl https://api.clipia.ai/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

<Callout type="info" title="Когда использовать что">
`/status` удобен для лёгкого опроса прогресса. Сам результат с медиа-URL забирайте через `GET /v1/requests/:id` (см. раздел «Результат»). Если передали `webhook_url` при `submit`, опрашивать статус вовсе не нужно.
</Callout>