Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.runblob.io/llms.txt

Use this file to discover all available pages before exploring further.

Base URL: https://platform.runblob.io

GET /v1/kling/o3-photo/generations/{generation_id}

generation_id
string
обязательно
Уникальный идентификатор, возвращённый из запроса generate
  • pending — задача создана, ожидает в очереди
  • processing — изображение генерируется
  • completed — генерация завершена, изображение готово
  • failed — генерация завершилась с ошибкой (детали в webhook)
curl -X GET https://platform.runblob.io/v1/kling/o3-photo/generations/550e8400-e29b-41d4-a716-446655440000 -H "Authorization: Bearer YOUR_API_KEY"

Примеры ответов

{
  "generation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "prompt": "A futuristic city with flying cars",
  "image_url": null,
  "model": "kling_o3_photo"
}
Опрашивайте этот эндпоинт раз в 3–5 секунд, пока статус не сменится на completed или failed.Ожидаемая хронология:
  • pendingprocessing: 10–30 секунд
  • processingcompleted: 1–3 минуты

Поля ответа

generation_id
string
Уникальный идентификатор генерации
status
string
Текущий статус: pending, processing, completed или failed
prompt
string
Исходный промпт для генерации
image_url
string | null
Прямой URL сгенерированного изображения (доступен только при completed)
model
string
Идентификатор модели: kling_o3_photo

Рекомендации по polling

1

Начните polling после генерации

Подождите 5–10 секунд перед первой проверкой, чтобы система успела поставить задачу в очередь
2

Используйте подходящие интервалы

Опрашивайте каждые 3–5 секунд. Более частый polling не ускорит генерацию и может упереться в лимиты
3

Установите тайм-аут

Прекратите polling после 5 минут. Если задача не завершена, считайте её неудачной и проверьте логи
4

Используйте webhooks в продакшене

В продакшене используйте webhooks вместо polling
Лимиты: максимум 60 проверок статуса в минуту на API-ключ. Используйте webhooks, чтобы не упереться в лимит.