Skip to main content
POST

Аутентификация

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

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

string
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • kling-3.0-turbo - Kling 3.0 Turbo
string
обязательно
Текстовый промптОграничение вышестоящего сервиса — не более 3072 символов, рекомендуется не более 2500 символов.Пример: "Корги бежит по берегу моря, кинематографичность, свет заката"
string
Поддерживается URL изображения или Base64.
Ограничения вышестоящего сервиса для изображения первого кадра:
  • Формат: .jpg / .jpeg / .png
  • Размер: ≤ 50MB
  • Ширина и высота: ≥ 300px
  • Соотношение сторон: 1:2.5 ~ 2.5:1
string
по умолчанию:"16:9"
Соотношение сторон видеоДопустимые значения:
  • 16:9 - горизонтальное
  • 9:16 - вертикальное
  • 1:1 - квадратное
Значение по умолчанию: 16:9
Действует только для генерации из текста. При генерации из изображения это поле не действует, соотношение сторон видео определяется первым кадром.
string
по умолчанию:"720p"
Четкость видеоДопустимые значения:
  • 720p
  • 1080p
Значение по умолчанию: 720p
integer
по умолчанию:"5"
Длительность видео (секунды)Диапазон значений: 3-15 (минимум 3 секунды, максимум 15 секунд)Значение по умолчанию: 5⚠️ Внимание: необходимо вводить только число (например, 6), без кавычек, иначе возникнет ошибка
boolean
Добавлять ли водяной знакПередается вышестоящему сервису только при явной передаче; если не передавать, водяной знак не добавляется.

Генерация из текста vs генерация из изображения

Система автоматически определяет режим генерации в зависимости от того, передан ли first_frame_image: при наличии изображения первого кадра выполняется генерация из изображения, без него — генерация из текста; пользователю не нужно явно это указывать.

Ответ

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

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

Сценарий 1: генерация из текста (1080P)

Сценарий 2: генерация из текста (вертикальное 720P)

Сценарий 3: генерация из изображения (изображение первого кадра)

Сценарий 4: генерация видео только по первому кадру (без промпта)

Сценарий 5: раскадровка с несколькими планами (генерация из текста)

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