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

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

Создаёт задачу генерации видео из текста или изображений через модель Kling O1 Video.
​
prompt
string
обязательно
Текстовое описание видео (1–2500 символов)
​
duration
string
обязательно
Длительность видео в секундах: "5" или "10"
​
aspect_ratio
string
обязательно
Соотношение сторон: "16:9" (ландшафт), "9:16" (портрет), "1:1" (квадрат)
​
images_base64
array
Массив изображений в Base64 (макс. 5, JPEG/PNG/WebP)
​
images_urls
array
Массив URL изображений (макс. 5, альтернатива images_base64)
​
keep_original_sound
boolean
по умолчанию:"true"
Сохранять оригинальный звук из изображений
​
callback_url
string
URL webhook для уведомлений о готовности
Передавайте либо images_base64, либо images_urls, но не оба сразу.
curl -X POST https://platform.runblob.io/v1/kling/o1-video/generate -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "prompt": "A cinematic shot of a cat walking in slow motion",
  "duration": "5",
  "aspect_ratio": "16:9"
}'

​
Ответ

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

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

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

​
1. Text-to-Video

Генерация видео только из текстового промпта (без изображений).
  • Длительность: "5" или "10" секунд
  • Параметры изображений не нужны
{
  "prompt": "Epic cinematic scene of a dragon flying",
  "duration": "10",
  "aspect_ratio": "16:9"
}

​
2. Image-to-Video

Анимация до 5 изображений с текстовым промптом.
  • Длительность: "5" или "10" секунд
  • Форматы: JPEG, PNG, WEBP
  • Макс. размер: 10 MB на изображение
  • Макс. изображений: 5
{
  "prompt": "Bring these photos to life with smooth animation",
  "images_urls": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg"
  ],
  "duration": "10",
  "aspect_ratio": "16:9"
}

​
Поддержка нескольких изображений

  • Изображения обрабатываются по порядку
  • Внутри они адресуются как @Image1, @Image2 и т.д.
  • Все изображения объединяются в одном видео
  • AI использует промпт для управления анимацией
  • Макс. размер: 10 MB на изображение
  • Форматы: JPEG, PNG, WebP
  • Макс. всего: 5 изображений на запрос
  • Либо URL, либо Base64 (не одновременно)
Доступные длительности:
  • 5 секунд
  • 10 секунд

​
Соотношения сторон

СоотношениеПрименениеРазрешение
16:9Ландшафт, YouTube, широкоформатОптимизировано под горизонталь
9:16Портрет, TikTok, Instagram ReelsОптимизировано под вертикаль/мобильное
1:1Квадрат, лента InstagramСбалансированный формат

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

400 Bad Request: 
{
  "detail": "Invalid duration. Only 5 or 10 seconds are supported"
}
402 Payment Required: 
{
  "detail": "INSUFFICIENT_CREDITS"
}
422 Validation Error: 
{
  "detail": "Maximum 5 images allowed"
}