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

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

Создаёт задачу генерации видео из текстового описания на базе Google Veo3.
​
prompt
string
обязательно
Текстовое описание видео (10–4000 символов)
​
model
string
по умолчанию:"veo-3-fast"
Версия модели: "veo-3-fast" или "veo-3-quality"
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео: "9:16" или "16:9"
​
seed
number
Seed для воспроизводимости (0–1000000000)
​
callback_url
string
URL webhook для уведомлений о готовности
​
watermark_text
string
Текст пользовательского водяного знака (3–14 символов)
​
bytes_image
string
Изображение в Base64 для image-to-video (макс. 20MB, JPEG/PNG/WEBP)
​
start_frame
string
Стартовый кадр в Base64 для режима Frame-to-Frame (требует end_frame)
​
end_frame
string
Конечный кадр в Base64 для режима Frame-to-Frame (требует start_frame)
​
reference_images
array
Массив из 1–3 изображений в Base64 для генерации по референсам (поддерживается только veo-3-fast)
curl -X POST https://platform.runblob.io/v1/veo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cat playing with a ball in a sunny room",
    "model": "veo-3-fast",
    "seed": 1234
  }'

​
Ответ

{
  "generation_id": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "pending",
  "seed": 319790131
}
​
generation_id
string
UUID задачи генерации для проверки статуса
​
status
string
Начальный статус, всегда "pending"
​
seed
number
Использованный seed (для воспроизводимости)
Генерация видео обычно занимает 1–10 минут. Используйте generation_id для проверки статуса или настройте webhooks для уведомлений.

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

API поддерживает 4 режима генерации — в одном запросе можно использовать только один:

​
1. Text-to-Video

Генерация видео только из текстового промпта (без изображений). Модели: veo-3-fast, veo-3-quality

​
2. Image-to-Video

Анимация одного изображения с текстовым промптом через параметр bytes_image.
  • Форматы: JPEG, PNG, WEBP
  • Максимальный размер: 20 MB
  • Модели: veo-3-fast, veo-3-quality

​
3. Frame-to-Frame

Плавный переход между двумя кадрами через start_frame и end_frame.
  • Оба кадра обязательны
  • Работает только с veo-3-fast
Frame-to-Frame требует оба параметра start_frame и end_frame. Передача только одного приведёт к ошибке.

​
4. Reference Images

Генерация видео по 1–3 референсным изображениям через reference_images.
  • Поддерживается 1–3 изображения (JPEG, PNG, WEBP, до 20 MB каждое)
  • Работает только с veo-3-fast
Проверка: В одном запросе допустим только один режим. Нельзя комбинировать bytes_image, start_frame/end_frame и reference_images.