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

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/o3-photo/generate

Создаёт асинхронную задачу Kling O3 Photo. Принимает до 10 референсных изображений (URL или Base64), поддерживает 1K/2K/4K и multi-shot композицию.
​
prompt
string
обязательно
Текстовое описание изображения (1–2500 символов)
​
images_url
array
Массив URL изображений для генерации по референсам (макс. 10, нельзя совмещать с images_base64)
​
images_base64
array
Массив изображений в Base64 для генерации по референсам (макс. 10, нельзя совмещать с images_url)
​
img_resolution
string
по умолчанию:"4k"
Разрешение: "1k", "2k" или "4k"
​
aspect_ratio
string
по умолчанию:"1:1"
Соотношение сторон. Доступные варианты:
  • "1:1" — квадрат (по умолчанию)
  • "auto" — автоопределение
  • "9:16" — вертикальный портрет
  • "2:3" — вертикальный
  • "3:4" — вертикальный
  • "4:3" — горизонтальный
  • "3:2" — горизонтальный
  • "16:9" — широкий экран
  • "21:9" — сверхширокий
​
prefer_multi_shots
boolean
по умолчанию:"false"
Сгенерировать несколько вариаций в одном изображении (экспериментальная функция)
​
callback_url
string
URL webhook для уведомлений о готовности
Ограничения на изображения:
  • Передавайте либо images_url, либо images_base64, но не оба
  • Максимум 10 изображений всего (URL + base64 суммарно)
  • Максимум 10 MB на изображение
  • Поддерживаемые форматы: JPEG, PNG, WEBP
curl -X POST https://platform.runblob.io/v1/kling/o3-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": "4k",
    "aspect_ratio": "16:9"
  }'

​
Ответ

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

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

Используйте входные изображения для генерации по референсам:
  • images_url: URL референсов (HTTPS)
  • images_base64: изображения в Base64
  • Максимум 10 изображений всего (URL + base64 суммарно)
  • Нельзя совмещать images_url и images_base64 в одном запросе
  • Поддерживаются JPEG, PNG, WEBP
  • Максимум 10 MB на изображение
  • AI использует их как визуальный референс
Выбор качества изображения:
  • 1K: быстрее, стандартное качество
  • 2K: больше деталей, рекомендуется для большинства задач
  • 4K: ультра-HD, для профессиональных работ (по умолчанию)
9 вариантов соотношения сторон:
  • 1:1: квадрат (по умолчанию)
  • Auto: автоматическое определение
  • Портрет: 9:16, 2:3, 3:4
  • Ландшафт: 4:3, 3:2, 16:9, 21:9
Несколько вариаций в одном изображении:
  • Установите prefer_multi_shots: true
  • Создаёт листы дизайна персонажей, вариации, разные ракурсы
  • Лучше всего работает с промптами вида “character design sheet”, “product from different angles”
  • Оптимально с 16:9 или 21:9

​
Ошибки в ответе

{
  "detail": "Prompt must be between 1 and 2500 characters"
}
Невалидные параметры запроса