Перейти к содержимому
Зарегистрироваться бесплатно
Kling

Kling Video API: текст, изображения и управление движением

Подключите Kling с BetterToken API Key и выбирайте поля, материалы и способ генерации по Model ID и операции.

Создавайте видео по тексту или изображениям либо управляйте движением с помощью изображения персонажа и видео движения. kling-v3 задаёт качество вывода через provider_options.kling.mode. Omni, Turbo и Motion Control используют собственные поля разрешения.

Подготовьте BetterToken API Key. Base URL — https://bettertoken.ai/v1, авторизация — Authorization: Bearer YOUR_API_KEY. Копируйте Model ID точно, с учётом регистра.

Каждый request.json ниже использует общий процесс: расчёт, подтверждение создания, опрос и скачивание. Расчёт не запускает генерацию; создание отправляет платную задачу. Актуальная стоимость — в каталоге моделей.

Модели и операции

Таблица показывает допустимые значения по операциям. Значения по умолчанию, количество материалов и ограничения сочетаний приведены в соответствующих разделах. Размеры материалов указаны из расчёта 1 MB = 1048576 байт.

Model IDОперацияДлительность (секунды)Качество выводаПропорцииАудиоРоли материалов
kling-3.0-turbotext_to_video5–10, шаг 5720p, 1080p16:9, 9:16, 1:1onНет
kling-v3-motion-controlreference_to_videoпо референсному видео 3–10 с720p, 1080pне передавайтеoff, onreference_image, reference_video
kling-v3-omnitext_to_video3–15, шаг 1720p, 1080p, 4k16:9, 9:16, 1:1off, onНет
kling-v3image_to_video3–15, шаг 1std, pro, 4kне передавайтеoff, onfirst_frame, last_frame
kling-v3text_to_video3–15, шаг 1std, pro, 4k16:9, 9:16, 1:1off, onНет

kling-v3 не принимает output.resolution, а при генерации по изображению — ещё и output.aspect_ratio. kling-v3-motion-control не принимает provider_options. Turbo создаёт видео только на 5 или 10 секунд, аудио всегда on.

Примеры материалов

Примеры генерации по изображению и референсу используют синюю керамическую кружку на белом столе. Оставьте пример изображения для проверки или сначала замените его публичным HTTPS-материалом, который вы вправе использовать и который соответствует ограничениям этой страницы.

Референс для генерации видео: синяя керамическая кружка на белом столе

Пример управления движением использует изображение мальчика и видео движения того же мальчика. Промпт соответствует этим материалам персонажа. Видео длится около 5,04 секунды, 1280 × 720, 24 fps.

Генерация по тексту

kling-3.0-turbo

Используйте эту операцию, если у вас есть только текстовое описание.

Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетonon
duration.modestringНетfixedfixed
duration.secondsintegerНет5–10, шаг 5 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 9:16, 1:116:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "kling-3.0-turbo",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.

kling-v3-omni

Используйте эту операцию, если у вас есть только текстовое описание.

Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетoff, onoff
duration.modestringНетfixedfixed
duration.secondsintegerНет3–15, шаг 1 с; только для фиксированной длительности3
output.aspect_ratiostringНет16:9, 9:16, 1:116:9
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p, 4k720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • При output.resolution="4k" обязательно задайте audio.mode="off".

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "kling-v3-omni",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.

kling-v3

Используйте эту операцию, если у вас есть только текстовое описание.

Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетoff, onoff
duration.modestringНетfixedfixed
duration.secondsintegerНет3–15, шаг 1 с; только для фиксированной длительности5
output.aspect_ratiostringНет16:9, 9:16, 1:116:9
output.formatstringНетmp4mp4
promptstringНетстрокаНет
provider_options.kling.camera_axisstringНетhorizontal, vertical, pan, tilt, roll, zoomНет
provider_options.kling.camera_typestringНетsimple, down_back, forward_up, right_turn_forward, left_turn_forwardНет
provider_options.kling.camera_valueintegerНет-10–10, шаг 1, не может быть 0Нет
provider_options.kling.modestringНетstd, pro, 4kstd
provider_options.kling.negative_promptstringНетстрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "kling-v3",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"aspect_ratio": "16:9"
},
"provider_options": {
"kling": {
"mode": "std"
}
}
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.

Генерация по изображению

kling-v3

Используйте эту операцию, чтобы задать изображениями первый кадр либо первый и последний кадры.

Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетoff, onoff
duration.modestringНетfixedfixed
duration.secondsintegerНет3–15, шаг 1 с; только для фиксированной длительности5
output.formatstringНетmp4mp4
promptstringНетстрокаНет
provider_options.kling.camera_axisstringНетhorizontal, vertical, pan, tilt, roll, zoomНет
provider_options.kling.camera_typestringНетsimple, down_back, forward_up, right_turn_forward, left_turn_forwardНет
provider_options.kling.camera_valueintegerНет-10–10, шаг 1, не может быть 0Нет
provider_options.kling.modestringНетstd, pro, 4kstd
provider_options.kling.negative_promptstringНетстрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, необязательно, не более 1jpg, jpeg, pngразмер не более 10 MB; ширина 300–100000 px; высота 300–100000 px
last_frameimage, необязательно, не более 1jpg, jpeg, pngразмер не более 10 MB; ширина 300–100000 px; высота 300–100000 px

Обязательность материалов также определяется ограничениями сочетаний ниже.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Передайте хотя бы одну роль: first_frame, last_frame.
  • При передаче last_frame не задавайте provider_options.kling.camera_type.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "kling-v3",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"provider_options": {
"kling": {
"mode": "std"
}
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
excludesУдалите поля, несовместимые с автоматической длительностью или последним кадром.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Генерация по референсам

kling-v3-motion-control

Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.

Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетoff, onoff
duration.modestringНетautoauto
duration.secondsintegerНетне передавайте; по референсному видео 3–10 сНет
output.formatstringНетmp4mp4
output.resolutionstringНет720p, 1080p720p
promptstringДастрокаНет
watermarkbooleanНетfalsefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, 1 (обязательно)jpg, jpeg, pngразмер не более 10 MB; ширина 300–16384 px; высота 300–16384 px
reference_videovideo, 1 (обязательно)mp4, movразмер не более 100 MB; длительность 3–10 с; всего для этой роли не более 10 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

Ограничения сочетаний

  • Используйте автоматическую длительность: выходное видео следует длительности референса. Не задавайте duration.seconds.

Передайте ровно 1 reference_image и 1 reference_video. Не задавайте пропорции или дополнительные provider_options.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "kling-v3-motion-control",
"operation": "reference_to_video",
"prompt": "Animate the boy in the reference image following the motion in the reference video. Preserve his appearance.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "person",
"type": "image",
"role": "reference_image",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0-poster.jpg"
},
{
"id": "motion",
"type": "video",
"role": "reference_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
excludesУдалите поля, несовместимые с автоматической длительностью или последним кадром.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Официальные материалы

При обращении к BetterToken используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.