Kling 2.6 API

Kling 2.6 создаёт короткие видео двумя способами:

• по текстовому описанию сцены;
• по загруженному изображению, которое модель оживляет.

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

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

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

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

Kling 2.6 поддерживает два режима:

• kling-2.6/text-to-video - генерация видео из текста;
• kling-2.6/image-to-video - генерация видео по изображению.

Тело запроса

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

{
  "tool": "kling-2-6",
  "input": {
    "...": "..."
  }
}

• tool - slug нейросети. Для этой модели всегда используйте "kling-2-6".
• input - параметры конкретного запуска.
• Набор полей внутри input зависит от выбранного model.

Параметры

Параметр	Тип	Обязательный	Описание
model	enum	Да	Режим запуска. Варианты: kling-2.6/text-to-video - видео из текста, kling-2.6/image-to-video - видео из изображения.
prompt	string	Да	Текстовое описание сцены, движения камеры и желаемого результата. Если включён звук, сюда можно добавить пожелания по речи, шумам или атмосфере. Максимум 2500 символов.
image_urls	string[] (url)	Да, для kling-2.6/image-to-video	Массив с одним внешним URL изображения. Поле нужно только для режима генерации по изображению. Разрешены только http/https ссылки. Максимум 1 файл. Допустимые расширения: .jpg, .jpeg, .png, .webp.
sound	boolean	Нет	Если true, модель пытается сгенерировать видео со звуком. Это влияет на итоговую цену.
aspect_ratio	enum	Да, для kling-2.6/text-to-video	Соотношение сторон для режима генерации из текста. Варианты: 1:1, 16:9, 9:16. Для режима по изображению это поле не нужно.
duration	enum	Да	Длительность ролика. Варианты: 5, 10. Влияет на цену.

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

Сценарий 1. Видео из текста

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "kling-2-6",
    "input": {
      "model": "kling-2.6/text-to-video",
      "prompt": "Ночной город после дождя, камера медленно движется вперёд по пустой улице, в лужах отражаются неоновые вывески, лёгкий туман и реалистичное освещение",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": true
    }
  }'

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-2-6',
    input: {
      model: 'kling-2.6/text-to-video',
      prompt:
        'Ночной город после дождя, камера медленно движется вперёд по пустой улице, в лужах отражаются неоновые вывески, лёгкий туман и реалистичное освещение',
      aspect_ratio: '16:9',
      duration: '5',
      sound: true,
    },
  }),
})

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-2-6",
        "input": {
            "model": "kling-2.6/text-to-video",
            "prompt": "Ночной город после дождя, камера медленно движется вперёд по пустой улице, в лужах отражаются неоновые вывески, лёгкий туман и реалистичное освещение",
            "aspect_ratio": "16:9",
            "duration": "5",
            "sound": True,
        },
    },
    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-2-6",
    "input": {
      "model": "kling-2.6/image-to-video",
      "prompt": "Девушка стоит у окна, камера плавно приближается, волосы и занавеска слегка движутся от ветра, мягкий кинематографичный свет",
      "image_urls": [
        "https://cdn.example.com/source-image-1.jpg"
      ],
      "duration": "10",
      "sound": false
    }
  }'

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-2-6',
    input: {
      model: 'kling-2.6/image-to-video',
      prompt:
        'Девушка стоит у окна, камера плавно приближается, волосы и занавеска слегка движутся от ветра, мягкий кинематографичный свет',
      image_urls: ['https://cdn.example.com/source-image-1.jpg'],
      duration: '10',
      sound: false,
    },
  }),
})

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-2-6",
        "input": {
            "model": "kling-2.6/image-to-video",
            "prompt": "Девушка стоит у окна, камера плавно приближается, волосы и занавеска слегка движутся от ветра, мягкий кинематографичный свет",
            "image_urls": ["https://cdn.example.com/source-image-1.jpg"],
            "duration": "10",
            "sound": False,
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "kling-2-6",
  "cost": 100,
  "balance_after": 495,
  "created_at": "2026-03-27T12:00:00Z"
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "kling-2-6",
  "cost": 100,
  "created_at": "2026-03-27T12:00:00Z",
  "completed_at": "2026-03-27T12:00:41Z",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/kling-2-6/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)

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

После успешного завершения Kling 2.6 возвращает результат в поле result:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/kling-2-6/result.mp4"
  ]
}

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

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

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

Базовая ставка начинается от 50 ₽.

Итоговая цена зависит от двух параметров:

• duration;
• sound.

Текущая матрица цен:

Длительность	Со звуком	Цена
5	false	50 ₽
10	false	100 ₽
5	true	100 ₽
10	true	200 ₽

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

• увеличение длительности повышает цену;
• включение звука тоже повышает цену;
• сам выбор режима text-to-video или image-to-video цену не меняет, если duration и sound одинаковые.

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

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую операцию.
• Все операции выполняются асинхронно: сначала вы получаете queued, затем отдельно проверяете статус по id.
• Для image_urls подходят только внешние http/https URL. localhost, private IP и внутренние ссылки не принимаются.
• Несмотря на то что поле называется image_urls, для Kling 2.6 сюда нужно передавать только одно изображение.
• В Public API для image_urls используйте только файлы .jpg, .jpeg, .png, .webp. Форматы HEIC/HEIF, которые могут встречаться в UI-загрузке, для внешних URL здесь не документируются.
• Для kling-2.6/text-to-video передавайте aspect_ratio и не передавайте image_urls.
• Для kling-2.6/image-to-video передавайте image_urls и не добавляйте aspect_ratio.
• Не опрашивайте GET /api/v1/operations/{id} слишком часто. Практически безопасно проверять статус примерно раз в секунду.