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

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

Создаёт задачу генерации видео из текстового описания через модели Kling AI.
​
prompt
string
обязательно
Текстовое описание видео (1–2500 символов)
​
negative_prompt
string
Что НЕ должно быть в видео (макс. 2500 символов)
​
model
string
по умолчанию:"kling_2.5_turbo"
Используемая модель.Доступные модели:
  • kling_3 (NEW: Kling 3.0 Standard — 720p, длительность 3–15s как int)
  • kling_3_pro (NEW: Kling 3.0 Pro — 1080p, длительность 3–15s как int)
  • kling_3_motion (NEW: Kling 3.0 Motion Control Standard — рекомендуется)
  • kling_3_motion_pro (NEW: Kling 3.0 Motion Control Pro)
  • kling_2.6_motion (Motion Control Standard, legacy)
  • kling_2.6_motion_pro (Motion Control Pro, legacy)
  • kling_2.6 (со звуком, всегда Pro-качество)
  • kling_2.5_turbo (Standard/Turbo)
  • kling_2.5_turbo_pro (Professional/Turbo Pro)
  • kling_2.1 (Standard)
  • kling_2.1_pro (Professional)
  • kling_2.1_master (Master, без pro-режима)
  • kling_1.6 (Standard)
  • kling_1.6_pro (Professional)
​
duration
string | int
по умолчанию:"5"
Длительность видео.
  • Для kling_3 / kling_3_pro: целое число от 3 до 15 (например, 4, 10). Цена считается посекундно.
  • Для остальных моделей: строка "5" или "10".
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео: "16:9", "9:16", "1:1"
Для image-to-video соотношение сторон автоматически берётся из входного изображения — указывать его не нужно.
​
cfg_scale
number
по умолчанию:"0.5"
Баланс креативности (0.0–1.0). 0.0 = максимум креативности, 1.0 = строгое следование промпту
​
seed
number
Seed для воспроизводимости (0–2147483647)
​
callback_url
string
URL webhook для уведомлений о готовности
​
image_base64
string
Изображение в Base64 для Image-to-Video (JPEG/PNG/WEBP)
​
image_url
string
URL изображения для Image-to-Video
​
reference_video_base64
string
Референсное видео в Base64 для Motion Control (MP4/MOV/WEBP)Требования:
  • Длительность: 3–30 секунд
​
reference_video_url
string
URL референсного видео для Motion Control
​
reference_image_base64
string
Референсное изображение в Base64 для Motion Control (JPEG/PNG/WEBP)
​
reference_image_url
string
URL референсного изображения для Motion Control
Требования Motion Control:
  • Нужны и reference_video, и reference_image
  • Длительность видео — от 3 до 30 секунд
  • Нельзя одновременно использовать _base64 и _url для одного типа медиа
curl -X POST https://platform.runblob.io/v1/kling/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling_3",
    "prompt": "A golden retriever running through a sunflower field at sunset",
    "duration": 4
  }'

​
Ответ

Standard/Pro модели: 
{
  "generation_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "price": "0.0250"
}
Motion Control: 
{
  "generation_id": "80844def-c17a-4381-9c07-036cb8c5f045",
  "status": "pending",
  "price": "0.3936"
}
Генерация видео обычно занимает 2–5 минут. Motion Control — 3–6 минут. Используйте generation_id для проверки статуса или настройте webhooks.

​
Ответ при проверке статуса

{
    "generation_id": "5b92cd9c-2ddf-45a4-9bd1-7b13afaf1186",
    "status": "completed",
    "prompt": "cat and dog play together",
    "video_url": "https://storage.runblob.io/...",
    "model": "kling_2.5_turbo"
}

​
Режимы генерации

API поддерживает 3 режима генерации:

​
1. Text-to-Video

Генерация видео только из текстового промпта (без изображений). Модели: kling_1.6, kling_2.1_master, kling_2.5_turbo, kling_2.6, kling_3, kling_3_pro
kling_2.1 и kling_2.1_pro НЕ поддерживают text-to-video. Им нужно входное изображение.

​
2. Image-to-Video

Анимация одного изображения с текстовым промптом через image_base64 или image_url.
  • Форматы: JPEG, PNG, WEBP
  • Макс. размер: ~10 MB
  • Модели: kling_1.6, kling_2.1, kling_2.1_master, kling_2.5_turbo, kling_2.6, kling_3, kling_3_pro (и их _pro-варианты)
Важно: нельзя использовать image_base64 и image_url одновременно. Для image-to-video соотношение сторон берётся из изображения автоматически.

​
3. Motion Control

Перенос движения и стиля с референсного видео на референсное изображение.
  • Обязательны: и reference_video, и reference_image
  • Длительность видео: 3–30 секунд
  • Форматы видео: MP4, MOV, WEBM
  • Форматы изображений: JPEG, PNG, WEBP
  • Модели: kling_3_motion, kling_3_motion_pro, kling_2.6_motion, kling_2.6_motion_pro
  • Цена: посекундно (с округлением вверх)
    • Standard: $0.041/сек
    • Pro: $0.082/сек (в 2 раза дороже)
  • Соотношение сторон и длительность: определяются автоматически из референсного видео
{
  "prompt": "Apply this motion to the scene",
  "model": "kling_2.6_motion",
  "reference_video_url": "https://example.com/motion.mp4",
  "reference_image_url": "https://example.com/scene.jpg"
}

​
Гид по моделям

​
Kling 3.0 (NEW)

  • Коды: kling_3, kling_3_pro
  • Возможности:
    • Text-to-video: да
    • Image-to-video: да
    • Motion Control: нет (используйте kling_3_motion / kling_3_motion_pro)
    • Negative prompt: да
    • CFG Scale: да
    • Длительность: целое 3–15 (посекундная оплата)
  • Разрешение:
    • kling_3: 720p
    • kling_3_pro: 1080p
  • Подходит: новейшее поколение — гибкая длительность и высокое качество
Для kling_3 и kling_3_pro передавайте duration как целое число (например, 4), а не строку. Диапазон: 3–15. По умолчанию: 5.

​
Kling 3.0 Motion Control (NEW — рекомендуется)

  • Коды: kling_3_motion, kling_3_motion_pro
  • Возможности:
    • Требуется референсное видео (3–30s) + референсное изображение
    • Длительность: автоопределяется из видео
    • Соотношение сторон: автоопределяется из видео
    • Negative prompt: да
    • CFG Scale: да
  • Улучшения по сравнению с 2.6 Motion:
    • Лучшая точность движения из референсного видео
    • Более реалистичная физика (волосы, одежда, жидкости)
    • Меньше артефактов и деформаций
    • Лучшее сохранение персонажа из референса
  • Цена: посекундно (та же ставка, что у kling_2.6_motion)
  • Подходит: перенос движения — заменяет kling_2.6_motion как рекомендуемая модель

​
Kling 2.6 Motion Control (Legacy)

  • Коды: kling_2.6_motion, kling_2.6_motion_pro
  • Возможности:
    • Перенос движения из референсного видео
    • Требуется референсное видео (3–30s) + изображение
    • Соотношение сторон: автоопределяется из видео
    • Длительность: автоопределяется из видео
    • Negative prompt: нет
    • CFG Scale: нет
  • Цена:
    • Standard: $0.041/сек
    • Pro: $0.082/сек (в 2 раза дороже)
  • Подходит: перенос движения и стиля с референсных видео

​
Kling 2.6

  • Код: kling_2.6
  • Возможности:
    • Text-to-video: да
    • Image-to-video: да
    • Поддержка звука: да
    • Всегда Pro-качество
    • Приоритетная обработка
    • Negative prompt: нет
    • CFG Scale: нет
  • Подходит: видео максимального качества со звуком

​
Kling 2.5 Turbo (по умолчанию)

  • Коды: kling_2.5_turbo, kling_2.5_turbo_pro
  • Возможности:
    • Text-to-video: да
    • Image-to-video: да
    • Negative prompt: нет
    • CFG Scale: нет
  • Подходит: максимально быстрая генерация

​
Kling 2.1 Master

  • Код: kling_2.1_master
  • Возможности:
    • Text-to-video: да
    • Image-to-video: да
    • Negative prompt: да
    • CFG Scale: нет
  • Подходит: высокое качество text-to-video

​
Kling 2.1 Pro

  • Коды: kling_2.1, kling_2.1_pro
  • Возможности:
    • Text-to-video: нет (нужно изображение)
    • Image-to-video: да
    • Negative prompt: да
    • CFG Scale: нет
  • Подходит: профессиональная анимация изображений

​
Kling 1.6

  • Коды: kling_1.6, kling_1.6_pro
  • Возможности:
    • Text-to-video: да
    • Image-to-video: да
    • Negative prompt: да
    • CFG Scale: да
  • Подходит: максимальный творческий контроль
Параметр баланса креативности (только Kling 1.6):
  • 0.0–0.3: максимум креативности, AI добавляет интерпретации
  • 0.4–0.6: сбалансированный режим (рекомендуется)
  • 0.7–1.0: строгое следование промпту, минимум отклонений