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

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

POST /v1/kling/o1-photo/generate

Создаёт асинхронную задачу Kling O1 Photo. Принимает до 5 референсных изображений (URL или Base64) и возвращает generation_id для polling или webhook.
prompt
string
обязательно
Текстовое описание изображения (1–2500 символов)
images_url
array
Массив из до 5 URL изображений для генерации по референсам
images_base64
array
Массив из до 5 изображений в Base64 для генерации по референсам
img_resolution
string
по умолчанию:"2k"
Разрешение изображения: "1k" или "2k"
aspect_ratio
string
по умолчанию:"1:1"
Соотношение сторон. Доступные варианты:
  • "9:16" — вертикальный портрет
  • "2:3" — вертикальный
  • "3:4" — вертикальный
  • "1:1" — квадрат (по умолчанию)
  • "4:3" — горизонтальный
  • "3:2" — горизонтальный
  • "16:9" — широкий экран
  • "21:9" — сверхширокий
callback_url
string
URL webhook для уведомлений о готовности
curl -X POST https://platform.runblob.io/v1/kling/o1-photo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city with flying cars, neon lights, cyberpunk style",
    "img_resolution": "2k",
    "aspect_ratio": "16:9"
  }'

Ответ

{
  "generation_id": "photo-550e8400-e29b-41d4-a716",
  "status": "pending",
  "price": "0.0290"
}
generation_id
string
UUID задачи генерации для проверки статуса
status
string
Начальный статус, всегда "pending"
price
string
Сумма списания в USD ($0.029 за изображение)
Генерация обычно занимает 1–2 минуты. Используйте generation_id для проверки статуса или настройте webhooks.Эндпоинт статуса: GET /v1/kling/o1-photo/generations/{generation_id}

Возможности генерации

Используйте до 5 входных изображений (всего из обоих источников):
  • images_url: URL референсов (HTTPS)
  • images_base64: изображения в Base64
  • Поддерживаются форматы JPEG, PNG, WEBP
  • AI использует их как визуальный референс
  • Максимум 10 MB на изображение
Выбор качества изображения:
  • 1K: быстрее, стандартное качество
  • 2K: больше деталей, рекомендуется для большинства задач
8 вариантов соотношения сторон:
  • Портрет: 9:16, 2:3, 3:4
  • Квадрат: 1:1
  • Ландшафт: 4:3, 3:2, 16:9, 21:9