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-turbo | text_to_video | 5–10, шаг 5 | 720p, 1080p | 16:9, 9:16, 1:1 | on | Нет |
kling-v3-motion-control | reference_to_video | по референсному видео 3–10 с | 720p, 1080p | не передавайте | off, on | reference_image, reference_video |
kling-v3-omni | text_to_video | 3–15, шаг 1 | 720p, 1080p, 4k | 16:9, 9:16, 1:1 | off, on | Нет |
kling-v3 | image_to_video | 3–15, шаг 1 | std, pro, 4k | не передавайте | off, on | first_frame, last_frame |
kling-v3 | text_to_video | 3–15, шаг 1 | std, pro, 4k | 16:9, 9:16, 1:1 | off, 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.mode | string | Нет | on | on |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 5–10, шаг 5 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | off, on | off |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 3–15, шаг 1 с; только для фиксированной длительности | 3 |
output.aspect_ratio | string | Нет | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p, 4k | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | off, on | off |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 3–15, шаг 1 с; только для фиксированной длительности | 5 |
output.aspect_ratio | string | Нет | 16:9, 9:16, 1:1 | 16:9 |
output.format | string | Нет | mp4 | mp4 |
prompt | string | Нет | строка | Нет |
provider_options.kling.camera_axis | string | Нет | horizontal, vertical, pan, tilt, roll, zoom | Нет |
provider_options.kling.camera_type | string | Нет | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Нет |
provider_options.kling.camera_value | integer | Нет | -10–10, шаг 1, не может быть 0 | Нет |
provider_options.kling.mode | string | Нет | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | Нет | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | off, on | off |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 3–15, шаг 1 с; только для фиксированной длительности | 5 |
output.format | string | Нет | mp4 | mp4 |
prompt | string | Нет | строка | Нет |
provider_options.kling.camera_axis | string | Нет | horizontal, vertical, pan, tilt, roll, zoom | Нет |
provider_options.kling.camera_type | string | Нет | simple, down_back, forward_up, right_turn_forward, left_turn_forward | Нет |
provider_options.kling.camera_value | integer | Нет | -10–10, шаг 1, не может быть 0 | Нет |
provider_options.kling.mode | string | Нет | std, pro, 4k | std |
provider_options.kling.negative_prompt | string | Нет | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, необязательно, не более 1 | jpg, jpeg, png | размер не более 10 MB; ширина 300–100000 px; высота 300–100000 px |
last_frame | image, необязательно, не более 1 | jpg, 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.mode | string | Нет | off, on | off |
duration.mode | string | Нет | auto | auto |
duration.seconds | integer | Нет | не передавайте; по референсному видео 3–10 с | Нет |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 720p, 1080p | 720p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, 1 (обязательно) | jpg, jpeg, png | размер не более 10 MB; ширина 300–16384 px; высота 300–16384 px |
reference_video | video, 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 используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.

