Skip to main content
POST

Авторизация

string
обязательно
Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключДобавьте его в заголовок запроса:

Параметры запроса

string
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • kling-v3 — Kling v3 (рекомендуется)
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовый промптПодробно описывайте сцены, действия и стили для лучших результатов генерации. Рекомендуется использовать промпты на английском языке.Пример: "a golden retriever running on the beach, sunset, cinematic"
string
Негативный промпт для исключения нежелательного содержимогоПример: "blurry, low quality, distorted"
string
по умолчанию:"std"
Режим генерацииВарианты:
  • std — стандартный режим (720P)
  • pro — профессиональный режим (1080P)
  • 4k — режим 4K
По умолчанию: std
integer
по умолчанию:"5"
По умолчанию: 5 Длительность видео (секунды)Диапазон: 3–15 (минимум 3 секунды, максимум 15 секунд)⚠️ Примечание: должно быть обычным числом (например, 6), без кавычек, иначе произойдёт ошибка
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 1:1 — квадратное
По умолчанию: 16:9
array<url>
Массив URL изображений для генерации image-to-video
  • Передайте 1 изображение: используется как первый кадр
  • Передайте 2 изображения: автоматически назначаются как первый кадр + последний кадр
Поддерживается не более 2 изображенийПример: ["https://example.com/first.jpg"]
  • Поддерживается не более 2 изображений
  • URL изображений должны быть публично доступны без защиты от хотлинкинга
  • В режиме image-to-video параметр aspect_ratio может быть переопределён фактическим соотношением сторон изображения
boolean
Добавлять ли водяной знак
boolean
по умолчанию:"false"
Генерировать ли видео со звуком
boolean
по умолчанию:"false"
Включать ли многокадровый режим.
  • true
  • false
string
Способ разбивки на кадры: customize / intelligence.Обязателен при multi_shot=true.
array<object>
Информация о каждом кадре, например prompt и длительность.Определяет порядок, промпт и длительность кадров через index, prompt и duration.
  • Поддерживается от 1 до 6 кадров
  • Максимальная длина содержимого каждого кадра — 512
  • Длительность каждого кадра должна быть >= 1 и не должна превышать общую длительность задачи
  • Сумма длительностей всех кадров должна равняться значению верхнего уровня duration
Формат:
Обязателен при multi_shot=true и shot_type=customize.
array<object>
Список референсных субъектов, до 3 субъектов.
  • Создаются «на лету» через name, description, element_input_urls
Пример:
Примечания:
  • Для создания «на лету» требуются name, description и element_input_urls
  • element_input_urls: 2–4 изображения на каждый субъект (первое — фронтальное, остальные — референсные)
  • Ссылайтесь на элементы в prompt через @name, например "@element_dog chasing @element_cat on grass"

Ограничения параметров

  • mode=4k поддерживается для kling-v3
  • image_urls поддерживает до 2 изображений (1 — первый кадр, 2 — первый+последний кадры)
  • Ввод только последнего кадра недопустим (обязательно должен быть первый кадр)
  • При multi_shot=true верхнеуровневый prompt можно опустить
  • multi_prompt поддерживает до 6 кадров, а index должен начинаться с 1 и быть непрерывным

Матрица поддержки функций

Текст в видео и Изображение в видео

Система автоматически определяет режим в зависимости от наличия image_urls: без изображений — text-to-video, с изображениями — image-to-video.

Ответ

integer
Код состояния ответа, 200 при успехе
array
Массив данных ответа

Сценарии использования

Сценарий 1: Текст в видео (стандартный режим)

Сценарий 2: Текст в видео (профессиональный режим + негативный промпт)

Сценарий 3: Текст в видео (15 секунд)

Сценарий 4: Изображение в видео (первый кадр)

Сценарий 5: Изображение в видео (управление первым + последним кадрами)

Сценарий 6: Генерация видео со звуком

Сценарий 7: Многокадровый сториборд (customize, 15 секунд, вертикальное со звуком)

Получение результатов задачиГенерация видео — это асинхронная задача, при отправке возвращающая task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.