Kling 3.0 Motion Control API

Краткое практическое введение

Kling 3.0 Motion Control нужен для сценариев, где у вас уже есть:

• одно изображение персонажа или объекта;
• одно референс-видео с нужным движением.

Модель переносит движение из видео на персонажа с изображения и возвращает готовый ролик. Это удобно для анимации персонажей, танцев, коротких сцен для рекламы и любых задач, где важно повторить жесты, темп и пластику из исходного видео.

В API у модели два практических режима:

• character_orientation = "video" - сильнее ориентируется на позы и динамику из референс-видео, подходит для роликов до 30 секунд;
• character_orientation = "image" - сильнее держится за исходное изображение, но подходит только для более коротких роликов, обычно до 10 секунд.

Каждый вызов создаёт асинхронную операцию. Сразу после запроса API возвращает id, стартовый статус и стоимость запуска, а готовый результат нужно получать отдельной проверкой статуса.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Запрос создаёт новую операцию и сразу возвращает id, стартовый статус и стоимость.
• Выполнение асинхронное.

Практически у Kling 3.0 Motion Control есть два сценария вызова:

• перенос движения с ориентацией по видео - character_orientation = "video";
• перенос движения с ориентацией по изображению - character_orientation = "image".

Тело запроса

Базовая форма запроса:

{
  "tool": "kling-3-0-motion-control",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети. Для этой модели всегда используйте "kling-3-0-motion-control".
• input - параметры конкретного запуска.
• В input_urls и video_urls передаются массивы URL, но для этой модели в каждый массив нужно передавать только по одному файлу.

Параметры

Параметр	Тип	Обязательный	Описание
prompt	string	Нет	Дополнительное текстовое описание сцены, внешнего вида и атмосферы. Полезно, когда нужно уточнить фон, стиль или настроение ролика. Максимум 2500 символов.
input_urls	string[] (url)	Да	Массив с одним внешним URL изображения персонажа или объекта, который нужно анимировать. Разрешены только http/https ссылки. Максимум 1 файл. Допустимые расширения: .jpg, .jpeg, .png.
video_urls	string[] (url)	Да	Массив с одним внешним URL референс-видео, из которого берётся движение. Разрешены только http/https ссылки. Максимум 1 файл. Допустимые расширения: .mp4, .mov.
character_orientation	enum	Да	Режим переноса движения. Варианты: video - сильнее повторяет движение и позы из видео, подходит для роликов до 30 секунд; image - сильнее держится за исходное изображение и доступен только для роликов до 10 секунд.
mode	enum	Да	Разрешение результата. Варианты: 720p, 1080p. Влияет на итоговую цену.

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

Сценарий 1. Ориентация по видео

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "kling-3-0-motion-control",
    "input": {
      "prompt": "Девушка повторяет движения из танцевального референса, мягкий студийный свет, аккуратный фон без лишних деталей",
      "input_urls": [
        "https://cdn.example.com/source-character-1.jpg"
      ],
      "video_urls": [
        "https://cdn.example.com/source-motion-1.mp4"
      ],
      "character_orientation": "video",
      "mode": "720p"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'kling-3-0-motion-control',
    input: {
      prompt:
        'Девушка повторяет движения из танцевального референса, мягкий студийный свет, аккуратный фон без лишних деталей',
      input_urls: ['https://cdn.example.com/source-character-1.jpg'],
      video_urls: ['https://cdn.example.com/source-motion-1.mp4'],
      character_orientation: 'video',
      mode: '720p',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "kling-3-0-motion-control",
        "input": {
            "prompt": "Девушка повторяет движения из танцевального референса, мягкий студийный свет, аккуратный фон без лишних деталей",
            "input_urls": ["https://cdn.example.com/source-character-1.jpg"],
            "video_urls": ["https://cdn.example.com/source-motion-1.mp4"],
            "character_orientation": "video",
            "mode": "720p",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Сценарий 2. Ориентация по изображению

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "kling-3-0-motion-control",
    "input": {
      "prompt": "Персонаж повторяет жест руками из короткого референса, сохраняет исходный ракурс и внешний вид, чистый светлый фон",
      "input_urls": [
        "https://cdn.example.com/source-character-2.png"
      ],
      "video_urls": [
        "https://cdn.example.com/source-motion-2.mov"
      ],
      "character_orientation": "image",
      "mode": "1080p"
    }
  }'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'kling-3-0-motion-control',
    input: {
      prompt:
        'Персонаж повторяет жест руками из короткого референса, сохраняет исходный ракурс и внешний вид, чистый светлый фон',
      input_urls: ['https://cdn.example.com/source-character-2.png'],
      video_urls: ['https://cdn.example.com/source-motion-2.mov'],
      character_orientation: 'image',
      mode: '1080p',
    },
  }),
})

const data = await response.json()
console.log(data)

Python

import requests

response = requests.post(
    "https://bratuha.ru/api/v1/operations",
    headers={
        "Authorization": "Bearer brth_ваш_ключ",
        "Content-Type": "application/json",
    },
    json={
        "tool": "kling-3-0-motion-control",
        "input": {
            "prompt": "Персонаж повторяет жест руками из короткого референса, сохраняет исходный ракурс и внешний вид, чистый светлый фон",
            "input_urls": ["https://cdn.example.com/source-character-2.png"],
            "video_urls": ["https://cdn.example.com/source-motion-2.mov"],
            "character_orientation": "image",
            "mode": "1080p",
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

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

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "kling-3-0-motion-control",
  "cost": 90,
  "balance_after": 495,
  "created_at": "2026-03-27T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "kling-3-0-motion-control",
  "cost": 90,
  "created_at": "2026-03-27T12:00:00Z",
  "completed_at": "2026-03-27T12:05:37Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/kling-3-0-motion-control/result.mp4"
    ]
  },
  "error_message": null
}

Проверка статуса

После создания операции сохраните id и используйте его для отдельной проверки статуса:

• Endpoint: GET /api/v1/operations/{id}
• Этот id возвращается сразу после POST /api/v1/operations.

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

const response = await fetch(
  'https://bratuha.ru/api/v1/operations/op_uuid-123',
  {
    headers: {
      Authorization: 'Bearer brth_ваш_ключ',
    },
  },
)

const data = await response.json()
console.log(data)

Формат результата

После успешного завершения операция возвращает result в таком формате:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/kling-3-0-motion-control/result.mp4"
  ]
}

Что важно знать:

• type всегда "video";
• urls - массив ссылок на готовые mp4-файлы;
• обычно для одного запуска возвращается один ролик, но результат лучше обрабатывать как массив ссылок.

Ценообразование

Базовая ставка начинается от 18 ₽ за секунду.

Итоговая цена зависит от двух вещей:

• выбранного разрешения mode;
• длительности референс-видео из video_urls.

Для расчёта цены секунды округляются вверх. Минимальная длина референс-видео - 3 секунды, максимальная - 30 секунд.

Текущие ставки:

Разрешение	Ставка
720p	18 ₽/сек
1080p	26 ₽/сек

Примеры расчёта:

• 720p и видео на 5 секунд - 90 ₽;
• 720p и видео на 7.2 секунды - 144 ₽, потому что длительность округляется вверх до 8;
• 1080p и видео на 10 секунд - 260 ₽.

Практически это означает:

• разрешение 1080p дороже 720p;
• чем длиннее референс-видео, тем выше цена;
• режим character_orientation = "image" доступен только для референс-видео длиной до 10 секунд.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.
• Все операции выполняются асинхронно: сначала вы получаете queued, затем отдельно проверяете статус по id.
• Для input_urls и video_urls подходят только внешние http/https URL. localhost, private IP и внутренние адреса не принимаются.
• Длительность video_urls определяется сервером по metadata видео до расчёта цены и до создания операции. Если сервер не может надёжно прочитать длительность референс-видео, запрос отклоняется с ошибкой, а операция не создаётся.
• Несмотря на то что input_urls и video_urls передаются массивами, для этой модели в каждом поле нужен только один URL.
• Для input_urls используйте только .jpg, .jpeg, .png. Для video_urls используйте только .mp4 и .mov.
• Если нужно максимально сохранить исходный ракурс и позу персонажа, используйте character_orientation = "image", но держите референс-видео коротким.
• Если важнее точнее повторить движения, темп и пластику из референс-видео, используйте character_orientation = "video".
• Для более стабильного результата лучше брать референс-видео без сильной тряски камеры, резких обрывов и тяжёлого смаза.
• Не опрашивайте GET /api/v1/operations/{id} слишком часто. Практически безопасно проверять статус примерно раз в секунду.