API Reference
Статус запроса
GET /v1/requests/{request_id}/status — узнать статус генерации.
Проверьте статус ранее поставленной генерации по её request_id.
Песочница
GET /v1/requests/:id/status возвращает текущий статус генерации, позицию в очереди и прогресс выполнения. Эндпоинт доступен любому валидному ключу — scope не требуется.
GET
/v1/requests/:id/statusЗапрос
Prop
Type
curl https://api.clipia.ai/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b/status \
-H "Authorization: Bearer $CLIPIA_KEY"const status = await clipia.queue.status('764cabcf-b745-4b3e-ae38-1200304cf45b');
console.log(status.status, status.progress);status = client.status("764cabcf-b745-4b3e-ae38-1200304cf45b")
print(status.status, status.progress)Ответ 200
{
"request_id": "764cabcf-b745-4b3e-ae38-1200304cf45b",
"status": "IN_PROGRESS",
"queue_position": null,
"progress": 45,
"logs": []
}Prop
Type
Получение результата
Тот же запрос без суффикса /status — GET /v1/requests/:id — возвращает финальный результат с полем output, когда статус терминальный, либо 202 пока генерация ещё в очереди или выполняется.
curl https://api.clipia.ai/v1/requests/764cabcf-b745-4b3e-ae38-1200304cf45b \
-H "Authorization: Bearer $CLIPIA_KEY"Когда использовать что
/status удобен для лёгкого опроса прогресса. Сам результат с медиа-URL забирайте через GET /v1/requests/:id (см. раздел «Результат»). Если передали webhook_url при submit, опрашивать статус вовсе не нужно.