guides

Kling 4.0 Flash API: параметры, цены и примеры кода

Poyo.ai Team
14 min read
Share:

Главное

  • Kling 4.0 Flash — быстрый и более доступный уровень Kling 4.0. Модель создаёт клипы на 3–20 секунд в 720p по тексту, начальному изображению или референсам, а также редактирует готовые видео.
  • Один ID модели охватывает все режимы. Отправьте "model": "kling-4.0-flash" на POST /api/generate/submit. Режим — генерацию по тексту, по изображению, по референсам или редактирование — определяют медиафайлы, которые вы передаёте.
  • В PoYo модель стоит $0.094 за секунду готового видео (18.8 кредита) для задач по тексту, изображению и референсам-изображениям, поэтому 5-секундный клип стоит $0.47, а 10-секундный — $0.94. Когда на входе есть видео, тариф составляет $0.063 за оплачиваемую секунду.
  • Оплата по факту использования с одним ключом. PoYo списывает за Flash кредиты по факту использования, без подписки, а тот же ключ и формат запроса подходят для Kling 4.0, Gemini Omni и Veo.
  • Результаты приходят асинхронно. Сохраните task_id, затем опрашивайте GET /api/generate/status/{task_id} или укажите callback_url.
  • Переход на Kling 4.0 — это замена одного слова. Обе модели используют одинаковые поля запроса; Kling 4.0 добавляет 1080p, клипы до 30 секунд, конечные кадры и промпты из нескольких планов.

Kling 4.0 Flash: краткий обзор

Kling 4.0 Flash в PoYo
РазработчикKuaishou (Kling AI)
ID модели в APIkling-4.0-flash
Страница модели/ru/models/kling-4-0-flash
РежимыТекст в видео, изображение в видео (один начальный кадр), видео по референсам, редактирование видео
Длина клипа3–20 секунд, целыми секундами; по умолчанию 5
Разрешение720p (8-битный SDR, по данным Kling)
Соотношения сторон16:9 (по умолчанию), 9:16, 1:1, 21:9, auto
РеференсыДо 10 изображений, 5 видео и 7 субъектов, всего 15 элементов
Лимит входного видеоВсе исходные, референсные видео и видео субъектов вместе — до 20 секунд
Длина промптаДо 26 000 символов
Цена$0.094/с · $0.063 за оплачиваемую секунду при видео на входе

Что такое Kling 4.0 Flash?

Kling 4.0 Flash — участник видеосемейства Kling 4.0 от Kuaishou, ориентированный на скорость. В собственном руководстве Kling описывает её как модель для частого создания контента, сочетающую «быструю генерацию с отличной выгодой», и указывает клипы на 3–20 секунд в 720p с генерацией видео по тексту, по изображению и Omni Reference. Полная модель Kling 4.0 в PoYo поддерживает до 30 секунд и 1080p и добавляет начальный и конечный кадры, а также промпты из нескольких планов.

«Kling 4 Flash» и «Kling 4.0 Flash» — одна и та же модель. В PoYo адрес страницы — kling-4-0-flash, а ID модели в API — kling-4.0-flash, с точкой.

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

Клип Kling 4.0 Flash в 720p: два мастера боевых искусств проводят спарринг в залитом солнцем деревянном додзё. Пример со страницы модели в PoYo.

Один ID модели, четыре режима

PoYo определяет режим по полям внутри input:

РежимЧто отправитьПримечания
Текст в видеоpromptВыберите aspect_ratio
Изображение в видеоimage_urls ровно с одним изображениемprompt необязателен; кадрирование задаёт начальное изображение
Видео по референсамreference_image_urls, reference_video_urls и/или kling_elementsНачальный кадр в image_urls по желанию; он учитывается в лимите 10 изображений
Редактирование видеоvideo_url + promptМожно добавить референсные изображения, до 4 референсных видео и субъекты; кадрирование повторяет исходное видео

Приоритет фиксирован: video_url включает редактирование, любое поле с референсами — генерацию по референсам, только image_urls — генерацию по изображению, а только промпт — генерацию по тексту.

Параметры запроса

model и callback_url указываются на верхнем уровне; все остальные поля — внутри input.

ПолеТипЗначения и ограниченияПо умолчанию
modelstringkling-4.0-flashОбязательное
callback_urlstringПубличный URL, на который придёт POST-запрос, когда задача завершится успешно или с ошибкой—
promptstring1–26 000 символов; обязателен для режимов текста, референсов и редактирования; необязателен для генерации по изображению—
durationinteger3–205; при редактировании — длина исходника
resolutionstring720p720p
aspect_ratiostringauto, 16:9, 9:16, 1:1, 21:9 (режимы текста и референсов)16:9
image_urlsarrayРовно одно начальное изображение—
reference_image_urlsarrayДо 10 изображений—
reference_video_urlsarrayДо 5 видео (4 при редактировании), каждое 3–20 секунд—
kling_elementsarrayДо 7 субъектов; у каждого либо element_input_urls (2–4 изображения, первым — вид анфас), либо element_input_video_urls (ровно одно видео на 3–8 секунд); до 3 видеосубъектов—
video_urlstringИсходное видео для редактирования, 3–20 секунд—

Общие ограничения, которые стоит проверить перед отправкой:

  • Всего 15 элементов: начальный кадр + референсные изображения + референсные видео + субъекты.
  • Всего 20 секунд входного видео: исходное видео + референсные видео + видеосубъекты.
  • Теги следуют порядку в массивах: @Image1, @Video1, @Element1. При редактировании исходное видео — это @Video1, а референсные видео начинаются с @Video2.
  • Форматы загрузки в Playground: MP4 или MOV, до 200 МБ на видео. URL медиафайлов должны быть публичными ссылками HTTP или HTTPS.

Отправка первого запроса

Создайте API-ключ в панели управления PoYo и храните его на своём сервере. Затем отправьте пятисекундную задачу генерации видео по тексту:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "A ceramic mug of coffee steams on a wooden windowsill as rain streaks the glass. Slow push-in, soft morning light, clean frame free of text and logos.",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

Успешная отправка возвращает code: 200 и задачу в data:

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

Ошибки валидации тоже могут приходить с HTTP 200 и code: 400, поэтому проверяйте поле code, а не только HTTP-статус. Код 402 означает, что на аккаунте нужно пополнить кредиты.

Другие примеры запросов

Изображение в видео по одному начальному кадру

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "The red panda shakes the snow off its fur, then turns toward the camera. Slow push-in, shallow depth of field.",
    "duration": 5
  }
}

Результат генерации по изображению: малая панда на заснеженной ветке бамбука стряхивает снег и поворачивается к камере. 5 секунд, 94 кредита. Пример со страницы модели в PoYo.

Видео по референсам с субъектом

Субъект ниже задан видом анфас и видом сбоку. Промпт ссылается на него как на @Element1, а на изображение локации — как на @Image1:

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "@Element1 walks along the cliff-top path toward the lighthouse in @Image1 at golden hour. The camera tracks beside him as he stops and looks up at the lamp. Keep his face and yellow raincoat consistent with @Element1.",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

Результат генерации по референсам: смотритель маяка в жёлтом дождевике и красной шапке идёт по тропе вдоль обрыва к маяку в золотой час — по изображению локации и субъекту с двумя ракурсами. 8 секунд, 9:16, 150.4 кредита. Пример со страницы модели в PoYo.

Редактирование готового клипа

По умолчанию результат сохраняет длину исходника:

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1 and change the season from winter to spring, using @Image1 as the environment reference. Keep the animal, its movements, timing and camera motion exactly as in @Video1."
  }
}

Результат редактирования: заснеженный клип с малой пандой из примера выше перенесён в весну с зелёным бамбуком и цветущей сакурой, а движения панды и камеры остались прежними. 151.2 кредита. Пример со страницы модели в PoYo.

Опрос статуса задачи

Проверить задачу можно в любой момент по её ID:

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

Статус переходит из not_started в running, а затем в finished или failed. Завершённая задача содержит видео в data.files с полями file_url и file_type: "video". У задачи с ошибкой есть error_message.

Цикл на Python с ограничением по времени для вашего бэкенда:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "A paper lantern drifts up over a night market. Slow tilt up, warm light, glowing stalls below.",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

Если цикл завершится по тайм-ауту, запросите тот же task_id позже; каждая новая отправка — это отдельный оплачиваемый клип. Для продакшен-конвейеров callback_url на верхнем уровне заменяет опрос вебхуком.

Стоимость клипа Kling 4.0 Flash

PoYo тарифицирует Flash посекундно из кредитов с оплатой по факту использования ($1 = 200 кредитов). Для задач по тексту, изображению и референсам-изображениям вы платите за длительность результата по единому тарифу, а референсные изображения и субъекты-изображения уже включены.

Длина результатаКредитыUSD
3 с56.4$0.282
5 с94$0.47
8 с150.4$0.752
10 с188$0.94
15 с282$1.41
20 с376$1.88

Для сравнения: тот же 5-секундный клип на Kling 4.0 в 720p стоит $0.7125, так что Flash примерно на 34% дешевле.

С видео на входе

Когда запрос включает исходное видео, референсные видео или видеосубъекты, тариф составляет 12.6 кредита ($0.063) за оплачиваемую секунду, где:

оплачиваемые секунды = длительность результата + max(общая длительность входного видео с округлением вверх, длительность результата)

ЗадачаОплачиваемые секундыКредитыUSD
Клип на 5 с по одному референсному видео на 4 с5 + max(4, 5) = 10126$0.63
Клип на 10 с по 12 с референсного видео10 + max(12, 10) = 22277.2$1.386
Редактирование клипа на 8 с с сохранением длины8 + max(8, 8) = 16201.6$1.008
Редактирование клипа на 15 с с одним референсным видео на 5 с15 + max(20, 15) = 35441$2.205

Дробная длина входного видео округляется вверх. В весенней правке на странице модели исходник длился чуть больше 5 секунд и был засчитан как 6: 6 + 6 = 12 оплачиваемых секунд, или 151.2 кредита. О бюджете для всего семейства Kling 4.0 читайте в нашем руководстве по ценам Kling 4.0 API.

Советы по промптам для Kling 4.0 Flash

  1. Одно непрерывное действие на клип. Короткие клипы получаются стабильнее всего, когда промпт ведёт один объект через одно действие: «поворачивается, замирает, смотрит вверх». Истории из нескольких событий оставьте для клипов на 10–20 секунд и стройте их как завязку, действие и развязку.
  2. Называйте движение камеры. Наезд, облёт, следящий план, подъём камеры. Выносите его в отдельное предложение, чтобы оно выделялось среди визуальных деталей.
  3. Описывайте свет и фактуру. Время суток, направление света и материалы — мокрое стекло, шлифованный металл или мех — придают клипу в 720p чёткий и цельный вид.
  4. Отмечайте тегом каждый входной файл. Ссылайтесь на медиа как на @Image1, @Video1 и @Element1 в порядке массивов и указывайте, за что отвечает каждый: внешность, локацию, движение или стиль.
  5. Тщательно собирайте субъектов. Ставьте вид анфас первым, добавляйте 1–3 дополнительных ракурса и используйте простой фон. Для видеосубъекта берите один чёткий клип на 3–8 секунд.
  6. Начинайте правки с «Edit @Video1». Затем опишите изменение и перечислите, что должно остаться прежним: внешность, движение, тайминг и траектория камеры.
  7. Просите чистый кадр. Добавляйте «чистый кадр без текста и логотипов», если планируете позже добавить подписи или брендинг.
  8. Подбирайте длину под идею. 5-секундного клипа хватает на один жест или раскрытие. 15–20 секунд оставьте для действий, которым нужно пространство, ведь стоимость растёт с каждой секундой.

Режиссура камеры в Kling 4.0 Flash: камера облетает гоночный автомобиль, дрифтующий сквозь дым под неоновыми огнями, а затем задерживается на его передней части. Пример со страницы модели в PoYo.

Больше приёмов составления промптов для всего семейства — в руководстве по промптам Kling 4.0 и руководстве по Omni Reference.

Kling 4.0 Flash и Kling 4.0 вкратце

Kling 4.0 FlashKling 4.0
ID моделиkling-4.0-flashkling-4.0
Разрешение720p720p, 1080p
Длина клипа3–20 с3–30 с
КадрыОдин начальный кадрНачальный и конечный кадры
Промпты из нескольких плановОдин промпт на клипmulti_prompt с длительностью для каждого плана
Референсы при редактированииИзображения, до 4 референсных видео и субъектыИзображения и субъекты-изображения
Цена в 720p, задачи по тексту и изображению$0.094/с$0.1425/с

Делайте черновики на Flash, а выбранное направление переносите на Kling 4.0, когда финальной версии нужны 1080p, конечный кадр или длина больше 20 секунд. Полное сравнение — в статье Kling 4.0 и Flash. Как Flash выглядит на фоне быстрых видеомоделей Google — в статье Gemini Omni 1.2 Flash, Kling 4.0 Flash и Veo 3.1.

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

Какой ID у модели Kling 4.0 Flash?

kling-4.0-flash. Адрес страницы kling-4-0-flash используется в URL. В теле запроса отправляйте "model": "kling-4.0-flash".

Сколько стоит Kling 4.0 Flash?

В PoYo — 18.8 кредита ($0.094) за секунду готового видео для задач по тексту, изображению и референсам-изображениям: $0.47 за 5 секунд, $0.94 за 10 секунд и $1.88 за 20 секунд. Когда на входе есть видео, — 12.6 кредита ($0.063) за оплачиваемую секунду.

Бесплатна ли Kling 4 Flash?

Kling 4.0 Flash работает в PoYo на кредитах с оплатой по факту использования, без подписки. Каждый запуск оплачивается с вашего баланса кредитов, а Playground показывает расчёт кредитов перед генерацией, так что стоимость промпта, набора референсов или правки можно проверить заранее.

Какой длины бывают видео Kling 4.0 Flash?

От 3 до 20 секунд за генерацию, целыми секундами. По умолчанию — 5 секунд, а правки сохраняют длину исходника, если вы не зададите duration.

Когда стоит переходить с Flash на Kling 4.0?

Flash создана для клипов в 720p по промпту, начальному кадру или референсам. Для 1080p, конечного кадра, multi_prompt или клипов длиной до 30 секунд используйте Kling 4.0 с теми же полями запроса.

Kling 4.0 Flash быстрее, чем Kling 4.0?

Kling описывает Flash как свой более быстрый уровень, созданный для частого создания контента и быстрых итераций. Время генерации зависит от длины клипа и текущей нагрузки, поэтому замерьте несколько своих промптов.

Можно ли использовать тот же ключ для других видеомоделей?

Да. Ключ PoYo, с которым работает Kling 4.0 Flash, подходит и для Kling 4.0, Gemini Omni 1.2 Flash, Veo 3.1 и других моделей — через те же конечные точки отправки и статуса и с одним балансом кредитов.

Можно ли получить вебхук, когда видео будет готово?

Да. Добавьте callback_url на верхнем уровне, и PoYo отправит на него POST-запрос, когда задача завершится успешно или с ошибкой. При этом статус по тому же task_id можно запрашивать в любой момент.

Share: