Руководство по ценам и интеграции API Kling

Текущая цена на reAPI для пятисекундного запроса к Kling API на text-to-video начинается с 385 кредитов ($0.385) с параметрами kling-3-0, mode: "std" и звуком отключённым. Полный маршрут Kling 3.0 поддерживает также анимацию первого и последнего кадра, встроенный звук, структурированные многоэтапные сценарии, переиспользуемые элементы и вывод в 4K. Kling 3.0 Turbo использует урезанный формат запроса, но его название не означает, что это самый дешёвый вариант: пятисекундный запрос Turbo в 720p стоит сейчас $0.630.^[1][3]

Это руководство охватывает контракт шлюза reAPI от первого POST до polling и сохранения файлов. Также показано, чем отличается официальное API Kling, чтобы поля и цены из одного интерфейса не попали случайно в запрос к другому.

TL;DR

• Для самого дешёвого черновика text-to-video пяти секунд в текущей таблице используйте kling-3-0 с параметрами mode: "std", sound: false и явной длительностью.
• Используйте kling-3-0, если вам нужны встроенный звук, первый и последний кадры, структурированное управление несколькими сценами, элементы или 4K. Используйте kling-3-0-turbo только когда его упрощённый workflow текста или первого кадра — это именно то, что вы хотите протестировать.
• Отправляйте каждый видеозапрос Kling через reAPI на POST /api/v1/videos/generations. Сохраните возвращённый id, затем опрашивайте GET /api/v1/tasks/{id} до конечного статуса completed или failed.
• Polling не потребляет кредиты. Интервала в две-три секунды достаточно; ответы для активных задач кэшируются пять секунд.^[6]
• Читайте usage.credits в финальной задаче. Большинство ошибок провайдера, timeout и отказов при сохранении возвращают кредиты, но некоторые ошибки безопасности после генерации могут удержать часть платежа.^[6]
• Скопируйте готовое видео в управляемое вами хранилище. Контракт задачи не гарантирует бесконечное хранение CDN.

Какую модель Kling API выбрать?

Начните с того, какие исходные данные у вас есть и какой контроль вам нужен. Motion Control — это не более дешёвая замена text-to-video, а Turbo — не просто более низкая цена полной модели.

Собственное руководство Kling описывает семейство VIDEO 3.0 как поддерживающее вывод три-пятнадцать секунд, text-to-video, image-to-video, начальный и конечный кадры, встроенный звук, многосценарные нарративы и ссылки на элементы.^[8] Допустимые поля зависят от API-интерфейса. На reAPI поля полной модели задокументированы в kling-3-0, а Turbo имеет другую схему в kling-3-0-turbo.

Motion Control требует своего workflow, так как исходное видео определяет движение и оплачиваемую длительность. Существующее руководство Motion Control API Kling подробно описывает ориентацию, подготовку исходного видео и дрейф идентичности.

Цены API Kling на 3 сентября 2026 года

reAPI выставляет счета за публичные маршруты Kling в секундах и рассчитывает в целых кредитах. Один кредит равен $0.001. Цены для полной версии и Turbo ниже были проверены на живом калькуляторе 3 сентября 2026 года; перед крупным заказом проверьте ещё раз страницы моделей, так как цены могут измениться.^[1][3]

Цены Kling 3.0 и Kling 3.0 Turbo

Доллары в итого отражают округление в целые кредиты. Например, пять секунд Kling 3.0 Pro со звуком рассчитываются как:

ceil($0.1485 × 5 секунд × 1000 кредитов за доллар)
= ceil(742.5)
= 743 кредита
= $0.743

Округление происходит один раз для всего запроса, а не для каждой секунды. В режиме структурированных многосценариев замените верхнеуровневую длительность на сумму длительностей сценариев. Четырёхсекундный сценарий, за которым следует пятисекундный, поэтому выставляется счёт за девять секунд.^[2]

Цены Motion Control

Эти ставки включены для того, чтобы можно было сравнить все четыре общедоступных ID. Длительность исходного видео округляется вверх при зондировании сервером; пользовательское поле duration отсутствует. Ставки в секунду получены со страницы живой модели Motion Control. Значения 5, 10 и 15 секунд — это рассчитанные сценарии для исходных видео длительностью, равной этим значениям, а не реальные данные с параметром duration.^[11]

Пятнадцатисекундный исходный материал допустим только когда Motion Control использует character_orientation: "video"; ориентация по изображению ограничивает исходный клип десятью секундами.^[5]

Не путайте кредиты reAPI, цены официального API и потребительские кредиты

Три категории могут называться словом «кредит» и относиться к разным продуктам. Они не взаимозаменяемы:

1. Кредиты reAPI рассчитывают запросы шлюза по $0.001 каждый. Это те кредиты, что в таблицах выше.
2. Цены официального Kling developer API — это прямое API Kuaishou, у которого собственный аккаунт, контракт запроса и таблица тарифов.
3. Потребительские кредиты Kling относятся к веб или приложению подписки. Они не влияют на стоимость запроса к reAPI или официальному developer API.

Для справки, таблица тарифов официального разработчика на 3 сентября показала Kling 3.0 полный за $0.084/$0.126 в секунду для 720p без/с встроенным звуком, $0.112/$0.168 для 1080p и $0.420 за 4K в любом случае.^[10] Это цены прямого API Kuaishou, а не доказательство того, что Kuaishou изменил свои цены, чтобы совпадать с таблицей reAPI. При планировании интеграции reAPI используйте ставку reAPI, привязанную к точному ID модели и полезной нагрузке, которую вы отправите.

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

Вам нужен ключ reAPI и, для image-to-video, медиа на публичном URL. Создайте ключ на странице ключей API, сохраните его в переменной окружения и не помещайте в код браузера или публичный репозиторий.

Все четыре общедоступных ID Kling используют одну и ту же конечную точку отправки:

POST https://reapi.ai/api/v1/videos/generations
GET  https://reapi.ai/api/v1/tasks/{id}

Запросы используют Bearer token:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Схемы строгие. Поле, скопированное из другого видео API, будет отклонено, а не проигнорировано. Входные медиа должны быть публичными HTTP(S) URL; локальные пути, data: URI и строки base64 этими маршрутами не принимаются.

Поля, принимаемые kling-3-0

Объект строгий, включая вложенные объекты сценариев и элементов. Обратите внимание на точное написание: поле звука — sound, поле уровня — mode, а 4K enum использует заглавную K.^[2]

Отправьте пятисекундный text-to-video запрос Kling

Это самая дешёвая комбинация для пятисекундного text-to-video в текущей таблице reAPI Kling: стандартное разрешение и без звука.

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A ceramic coffee cup on a wooden table as morning light moves slowly across the surface, locked camera, natural shadows",
    "duration": 5,
    "aspect_ratio": "16:9",
    "mode": "std",
    "sound": false
  }'

Успешная отправка возвращает запись задачи, не видео:

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "kling-3-0",
  "status": "processing",
  "created_at": 1735000000
}

Поле для сохранения — это id. Не пишите код клиента, который ждёт task_id; такой ключ в ответе не содержится.

Безопасный polling, обработка ошибок и сохранение видео

Полный flow — это один POST, за которым следуют ограниченные GET запросы. POST находится вне цикла polling. Это важно: повторение отправки может создать и выставить счёт за другое видео, а повторение запроса задачи только читает существующую работу.

Следующий скрипт работает на Node.js 20 или новее. Он отправляет один пятисекундный запрос, опрашивает каждые три секунды, повторяет попытки безопасного чтения задачи после rate limit или временных ошибок шлюза и записывает готовый MP4 в текущий каталог.

import { writeFile } from 'node:fs/promises';

const API_BASE = 'https://reapi.ai/api/v1';
const API_KEY = process.env.REAPI_API_KEY;
const OUTPUT_FILE = 'kling-output.mp4';

if (!API_KEY) throw new Error('Set REAPI_API_KEY before running this script');

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function parseResponse(response) {
  const body = await response.json().catch(() => ({}));
  if (response.ok) return body;

  const code = body.error?.code ?? response.status;
  const message = body.error?.message ?? response.statusText;
  const error = new Error(`${code}: ${message}`);
  error.status = response.status;
  error.retryAfter = response.headers.get('retry-after');
  throw error;
}

async function submitVideo() {
  const response = await fetch(`${API_BASE}/videos/generations`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'kling-3-0',
      prompt:
        'A ceramic coffee cup on a wooden table as morning light moves slowly across the surface, locked camera, natural shadows',
      duration: 5,
      aspect_ratio: '16:9',
      mode: 'std',
      sound: false,
    }),
  });

  // Intentionally no automatic POST retry: an uncertain response could hide
  // a task that was already created.
  return parseResponse(response);
}

async function readTask(taskId) {
  for (let attempt = 0; attempt < 5; attempt += 1) {
    try {
      const response = await fetch(`${API_BASE}/tasks/${taskId}`, {
        headers: { Authorization: `Bearer ${API_KEY}` },
      });
      return await parseResponse(response);
    } catch (error) {
      const retryable =
        error.status === 429 || [502, 503, 504].includes(error.status);
      if (!retryable || attempt === 4) throw error;

      const retryAfterSeconds = Number(error.retryAfter);
      const delay =
        error.status === 429 && Number.isFinite(retryAfterSeconds)
          ? retryAfterSeconds * 1000
          : Math.min(2 ** attempt * 1000, 8000);
      await sleep(delay);
    }
  }
}

async function waitForVideo(taskId) {
  const deadline = Date.now() + 30 * 60 * 1000;

  while (Date.now() < deadline) {
    await sleep(3000);
    const task = await readTask(taskId);

    if (task.status === 'completed') {
      const videoUrl = task.output?.video_urls?.[0];
      if (!videoUrl) throw new Error('Task completed without a video URL');
      return { videoUrl, credits: task.usage?.credits };
    }

    if (task.status === 'failed') {
      const code = task.error?.code ?? 'UNKNOWN_TASK_ERROR';
      const message = task.error?.message ?? 'Video generation failed';
      const credits = task.usage?.credits ?? 'unknown';
      throw new Error(`${code}: ${message}; settled credits: ${credits}`);
    }
  }

  throw new Error(`Client polling deadline reached for ${taskId}`);
}

async function downloadVideo(url) {
  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`Video download failed with HTTP ${response.status}`);
  }
  await writeFile(OUTPUT_FILE, Buffer.from(await response.arrayBuffer()));
}

const submitted = await submitVideo();
console.log(`Submitted ${submitted.id}`);

const result = await waitForVideo(submitted.id);
await downloadVideo(result.videoUrl);
console.log(`Saved ${OUTPUT_FILE}; settled credits: ${result.credits}`);

Тридцатиминутный дедлайн относится к этому примеру, а не к контракту API. Видеозадачи могут занимать минуты, а документированный потолок wall-clock worker — 48 часов. Выберите таймаут клиента, который подходит вашему продукту, сохраняйте ID задачи и позвольте фоновому работнику возобновить polling, а не держать один веб-запрос открытым.^[6]

Локальное сохранение MP4 доказывает, что загрузка работает. В production сохраняйте ответ в S3, R2 или другое хранилище объектов и сохраняйте надёжный URL рядом с ID задачи. Сделайте это как только задача завершится; контракт задачи reAPI не гарантирует постоянное хранение для сгенерированных URL.

Превратьте одно изображение — или первый и последний кадры — в видео

Полный маршрут Kling 3.0 переключается на image-to-video, когда присутствует image_urls. Первый URL — это открывающий кадр; опциональный второй URL — конечный кадр. Однократный prompt остаётся обязательным.

{
  "model": "kling-3-0",
  "prompt": "The camera moves gently toward the bottle while the reflected light travels from left to right; preserve the label and bottle shape",
  "image_urls": [
    "https://assets.example.com/bottle-start.png",
    "https://assets.example.com/bottle-end.png"
  ],
  "duration": 6,
  "mode": "pro",
  "sound": false
}

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

Если вам нужен только первый кадр, передайте один URL. Для более широкого сравнения workflows первого кадра, первого и последнего, и ссылочного изображения см. руководство image-to-video API.

Добавьте встроенный звук и структурированное управление несколькими сценами

kling-3-0 предоставляет звук через boolean sound. Его режим структурированных многосценариев заменяет единый верхнеуровневый prompt на до пяти объектов prompt-и-duration. Каждый prompt сценария принимает 1–500 символов, а каждая длительность сценария должна быть integer от 1 до 12 секунд.^[2]

{
  "model": "kling-3-0",
  "aspect_ratio": "16:9",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {
      "prompt": "Close shot of a barista placing a cup on the counter; soft room tone and a quiet ceramic tap",
      "duration": 4
    },
    {
      "prompt": "Cut to a wider view as morning customers enter; the room ambience continues naturally",
      "duration": 5
    }
  ]
}

Этот запрос выставляет счёт за девять Pro-with-audio секунд: 1337 кредитов, или $1.337 по ставке, проверенной для этой статьи. Нет необходимости добавлять верхнеуровневую duration для расчёта цены; две длительности сценариев — это оплачиваемый итог.

Для повторяющегося предмета или продукта тот же полный маршрут принимает до трёх kling_elements. Каждый элемент требует имя и два-четыре URL ссылочного изображения, а также может включать описание. Ссылайтесь на него в prompt как @name:

{
  "model": "kling-3-0",
  "prompt": "Slow orbit around @bluebottle on a stone pedestal; keep the cap, glass shape, and front label unchanged",
  "kling_elements": [
    {
      "name": "bluebottle",
      "description": "A rectangular cobalt-blue perfume bottle",
      "element_input_urls": [
        "https://assets.example.com/bottle-front.png",
        "https://assets.example.com/bottle-side.png"
      ]
    }
  ],
  "duration": 5,
  "mode": "pro"
}

Элемент — это ссылочное доказательство, а не гарантия того, что каждая маленькая этикетка или поверхность сохранятся при движении. Отдельно проверьте идентичность, текст, геометрию и отражения перед одобрением пакета.

Когда Kling 3.0 Turbo — правильный выбор

Схема reAPI Turbo намеренно меньше. Она поддерживает text-to-video или анимацию из одного первого кадра, с разрешением 720p/1080p и опциональным водяным знаком. Она не предоставляет полный sound, last-frame, multi_prompt, kling_elements или 4K fields Kling 3.0.^[4]

Запрос с первым кадром выглядит так:

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "The dog looks toward the sea as wind moves its fur; gentle handheld camera",
    "first_frame_image": "https://assets.example.com/dog-on-beach.jpg",
    "resolution": "720p",
    "duration": 5,
    "watermark": false
  }'

Когда first_frame_image присутствует, исходное изображение фиксирует соотношение сторон и prompt может быть опущен. Для text-to-video prompt обязателен, а aspect_ratio принимает 16:9, 9:16 или 1:1.

Слово «Turbo» легко неправильно прочитать. На проверенную дату 720p Turbo стоил $0.12584 в секунду, дороже полного Kling 3.0 Standard без звука на $0.077 и Pro без звука на $0.099. Эта статья не представляет контролируемого бенчмарка latency или качества вывода, поэтому выбирайте Turbo для его маршрута и наблюдаемых результатов на вашей нагрузке — а не потому, что название подразумевает выигрыш по цене.

Обрабатывайте валидацию, retry и возвраты без дублирования работ

Разделяйте ошибки, требующие изменения запроса, от ошибок, оправдывающих ещё одно чтение. Каталог ошибок использует числовой код внутри стандартного конверта { error: { code, message, request_id } }.^[7]

Ошибки задачи появляются внутри успешного HTTP 200 ответа polling. Коды в диапазоне 8xxxx различают отказ отправки, timeout workflow, терминальный отказ upstream, отсутствующие URL вывода, отказ persisten-ции, отказ политики контента, невалидный upstream input и отмену.^[7]

Поведение возвратов одинаково специфично. Отказы провайдера, timeouts и отказы persisten-ции возвращают кредиты при завершении workflow. Некоторые постгенерационные политики безопасности, специфичные для модели, могут скрыть вывод, но удержать платёж. На неудачной задаче usage.credits: 0 означает полный возврат резервирования; положительное значение — сумма удержанного платежа.^[6]

Не повторяйте POST автоматически, когда сеть даёт сбой после отправки тела. Документированная поверхность reAPI не предоставляет ключ идемпотентности для этой отправки, поэтому исходная работа может уже существовать. Логируйте request_id, ID задачи, если доступен, timestamp, модель и хеш полезной нагрузки. Автоматические повторы лучше зарезервировать для task GETs и других идемпотентных чтений.

Поля официального Kling API — это не поля reAPI

Семейство моделей одно и то же, но два API — это отдельные продукты. Официальные примеры Kling используют https://api-singapore.klingai.com, пути, специфичные для модальности, такие как /text-to-video/kling-3.0, вложенные settings и options, и запрос задачи по /tasks?task_ids=....^[9] Его запрос image-to-video использует отдельный путь и структуру contents.^[12] reAPI использует один путь video-generation и выбирает маршрут из плоского поля model.

Это различие объясняет несколько распространённых ошибок интеграции. Официальная полезная нагрузка, содержащая settings.resolution, не валидна на строгой схеме reAPI. Клиент reAPI, ожидающий succeeded, также будет ждать после валидного результата completed. Выберите один контракт и используйте его ключ, поля, имена статусов и источник цены от начала до конца.

Production checklist

Перед отправкой Kling workflow в очередь проверьте части, которые сложно восстановить позже:

• Закрепите точный публичный ID модели и запишите дату проверки цены.
• Валидируйте длительность, разрешение или режим, соотношение сторон, звук и количество сценариев перед отправкой.
• Сделайте каждый URL медиа доступным без cookies, истекающих сеансов браузера или локального сетевого доступа.
• Сохраняйте возвращённый id перед началом polling.
• Опрашивайте в фоновой работе с дедлайном и соблюдайте Retry-After.
• Рассматривайте completed и failed как терминальные; записывайте usage.credits для обоих.
• Скопируйте готовые файлы в надёжное хранилище и сохраняйте итоговый URL хранилища.
• Логируйте request_id для ошибок отправки и вложенную ошибку задачи для асинхронных отказов.
• Отдельно проверьте визуальное принятие от завершения API. Готовый клип всё ещё может быть непригодным для вашего продукта.

Эта последняя точка меняет реальную экономику единицы. Таблица API даёт стоимость за завершённый запрос. Бюджет production должен использовать итоговый выставленный счёт / принятые клипы, включая завершённые генерации, которые не прошли вашу визуальную проверку. Для более широкого объяснения смешанных единиц биллинга и стоимости приёмки см. AI video generation API pricing.

Часто задаваемые вопросы

Сколько стоит Kling API за пять секунд?

На reAPI на 3 сентября 2026 года text-to-video пяти секунд варьировался от $0.385 для полного Kling 3.0 Standard без звука до $1.843 за 4K. Turbo стоил $0.630 в 720p и $0.788 в 1080p. Проверьте живую страницу модели перед отправкой, так как цены могут меняться.

Kling 3.0 Turbo дешевле, чем Kling 3.0?

Нет, в проверенной таблице reAPI. Turbo 720p был $0.12584 в секунду, в то время как полный Kling 3.0 Standard без звука был $0.077 и Pro без звука был $0.099. Выбирайте Turbo для его специфичного маршрута и поведения вывода, а не его названия.

Может ли Kling API анимировать и первый, и последний кадр?

Да, с kling-3-0 на reAPI. Поместите первый кадр на индекс 0, а опциональный последний кадр на индекс 1 в image_urls. Turbo принимает только один first_frame_image.

Генерирует ли Kling 3.0 звук?

Полный маршрут kling-3-0 предоставляет встроенный звук через sound: true. Запросы Standard и Pro со звуком имеют более высокие текущие ставки в секунду, чем их беззвучные версии. Схема reAPI Turbo не предоставляет поле sound.

Как часто следует опрашивать видеозадачу Kling?

Каждые две-три секунды — разумный начальный интервал. Более быстрый polling не ускорит генерацию, и ответы для активных задач кэшируются пять секунд. Используйте фонового работника и клиентский дедлайн.

Выставляется ли счёт за неудачные Kling API задачи?

Читайте терминальную задачу, а не предполагайте. На reAPI failed с usage.credits: 0 означает полный возврат резервирования. Положительное значение означает задокументированный заряд, специфичный для модели, который может возникнуть после определённых постгенерационных решений безопасности.

Могу ли я отправить base64 изображения на эти маршруты reAPI Kling?

Нет. Шлюз принимает публичные HTTP(S) URL медиа для этих полей. Загрузите изображение в хранилище сначала, затем отправьте его URL.

Заключение

Надёжный план ценообразования и интеграции Kling API начинается с точного маршрута, а не названия семейства моделей. Для новой build text-to-video полный Kling 3.0 Standard без звука — текущая самая дешёвая начальная точка; добавляйте Pro, звук, структурированные сценарии, последние кадры или 4K только когда вывод их требует. Отправьте один раз, сохраните ответ id, опрашивайте задачу с дедлайном, проверьте выставленные кредиты и переместите каждое принятое видео в управляемое хранилище.

Страницы модели Kling 3.0 и модели Turbo содержат текущие цены reAPI. Держите Tasks API и справочник ошибок рядом с кодом при подключении первого production queue.

References

1. reAPI Kling 3.0 model and live pricing page, accessed September 3, 2026.
2. reAPI Kling 3.0 API documentation, accessed September 3, 2026.
3. reAPI Kling 3.0 Turbo model and live pricing page, accessed September 3, 2026.
4. reAPI Kling 3.0 Turbo API documentation, accessed September 3, 2026.
5. reAPI Kling Motion Control API documentation, accessed September 3, 2026.
6. reAPI Tasks API reference, accessed September 3, 2026.
7. reAPI error-code reference, accessed September 3, 2026.
8. Kling VIDEO 3.0 Model User Guide, Kuaishou, February 6, 2026; accessed September 3, 2026.
9. Kling AI Open Platform: VIDEO 3.0 text-to-video API, accessed September 3, 2026.
10. Kling AI Open Platform video-generation pricing, accessed September 3, 2026.
11. reAPI Kling Motion Control model and live pricing page, accessed September 3, 2026.
12. Kling AI Open Platform: VIDEO 3.0 image-to-video API, accessed September 3, 2026.