Kling v3
Генерация видео Kling v3
- Асинхронный режим обработки, возвращает идентификатор задачи для последующих запросов
- Поддерживает text-to-video, image-to-video (управление первым кадром / первым и последним кадрами)
- Поддерживает стандартный режим (720P), профессиональный режим (1080P) и режим 4K
- Поддерживает длительность видео от 3 до 15 секунд
- Поддерживает генерацию видео со звуком
POST
Авторизация
string
обязательно
Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключДобавьте его в заголовок запроса:
Параметры запроса
string
обязательно
Название модели генерации видеоПоддерживаемые модели:
kling-v3— Kling v3 (рекомендуется)
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
true: проверить промпты и входные изображения с помощьюomni-moderation-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовый промптПодробно описывайте сцены, действия и стили для лучших результатов генерации. Рекомендуется использовать промпты на английском языке.Пример:
"a golden retriever running on the beach, sunset, cinematic"string
Негативный промпт для исключения нежелательного содержимогоПример:
"blurry, low quality, distorted"string
по умолчанию:"std"
Режим генерацииВарианты:
std— стандартный режим (720P)pro— профессиональный режим (1080P)4k— режим 4K
stdinteger
по умолчанию:"5"
По умолчанию:
5
Длительность видео (секунды)Диапазон: 3–15 (минимум 3 секунды, максимум 15 секунд)⚠️ Примечание: должно быть обычным числом (например, 6), без кавычек, иначе произойдёт ошибкаstring
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
16:9— горизонтальное9:16— вертикальное1:1— квадратное
16:9array<url>
Массив URL изображений для генерации image-to-video
- Передайте 1 изображение: используется как первый кадр
- Передайте 2 изображения: автоматически назначаются как первый кадр + последний кадр
["https://example.com/first.jpg"]boolean
Добавлять ли водяной знак
boolean
по умолчанию:"false"
Генерировать ли видео со звуком
boolean
по умолчанию:"false"
Включать ли многокадровый режим.
truefalse
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-v3image_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. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.