Как пользоваться Kling 2.5 Turbo API? Первое видео за 5 минут

TL;DR

• Kling 2.5 Turbo — быстрая версия видеомодели Kuaishou Kling; на HiAPI есть два входа — текст-в-видео и изображение-в-видео. Откройте страницу модели, чтобы попробовать онлайн. Новым пользователям при регистрации начисляется 200 кредитов.
• Оба входа стоят $0.06 за секунду: 5 секунд — $0.30, 10 секунд — $0.60.
• Как вызывать: отправить POST /v1/tasks, получить taskId для проверки результата, готовое видео находится в output[0].url.

Что умеет Kling 2.5 Turbo

• 5 или 10 секунд, около 1080p: разрешение зависит от соотношения сторон, 16:9 выдаёт 1920×1080, отдельно задавать не нужно.
• Текст-в-видео сразу со звуком: у каждого видео есть звуковая дорожка, переключателя нет.
• Изображение-в-видео поддерживает последний кадр: первый кадр задаёт начало, последний — конец, модель достраивает промежуточный процесс.
• У изображение-в-видео 6 соотношений сторон: помимо горизонтального, вертикального и квадратного есть 4:3, 3:4 и широкоэкранное 21:9.

Vertical cinematic shot of a ceramic artist in a sunlit studio. Her hands shape a small terracotta bowl on a spinning pottery wheel. The wet clay gradually rises as the wheel turns, a little water glints on the surface. The camera gently tracks upward from the bowl to her focused face. Warm morning light, linen apron, natural movement, one continuous shot, no text or logos.

Сгенерировать с этим промптом → (выберите 10 секунд, 9:16)

kling-2.5-turbo/text-to-video, 9:16, 1080×1920, 10 секунд, со звуковой дорожкой, $0.60.

Как выбрать между двумя входами

ID модели	Вход	Соотношение сторон	Звук	Для чего
kling-2.5-turbo/text-to-video	Промпт	16:9, 9:16, 1:1	Со звуковой дорожкой	Нет материала, начинаем с текста
kling-2.5-turbo/image-to-video	Первый кадр обязателен, последний опционален	6 видов; с последним кадром — 3	Без звуковой дорожки	Оживить товарные фото, фотографии, иллюстрации

Оба входа по одной цене — $0.06 за секунду.

Два способа начать

Попробовать в браузере (3 шага)

1. Откройте страницу модели текст-в-видео или изображение-в-видео и войдите.
2. Напишите промпт; для изображение-в-видео сначала загрузите первый кадр, при необходимости — последний.
3. Выберите 5 секунд и соотношение сторон, нажмите запуск.

Вызов через API (3 шага)

1. Создайте ключ на странице API Key в консоли и поместите его в переменную окружения HIAPI_KEY.
2. Отправьте POST https://api.hiapi.ai/v1/tasks, вернётся data.taskId.
3. Проверьте через GET /v1/tasks/{taskId}, что status равен success, и скачайте output[0].url.

curl: первое видео

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5-turbo/text-to-video",
    "input": {
      "prompt": "Hands pour glossy caramel over a stack of pancakes, steam rises, camera slowly pushes in, warm kitchen light",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 секунд, 16:9, $0.30. Для изображение-в-видео замените model на kling-2.5-turbo/image-to-video и добавьте "image_urls": ["https://ваш-хостинг-изображений/frame.jpg"].

Python: отправка, опрос, скачивание

# pip install requests; сначала export HIAPI_KEY=ваш_ключ
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # При повторной попытке с той же задачей передавайте тот же Idempotency-Key, чтобы избежать двойного списания
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Первый кадр + последний кадр: красная машина едет слева направо и становится синей (5 секунд, $0.30)
url = generate(
    "kling-2.5-turbo/image-to-video",
    prompt="A toy car moves smoothly from the left to the right and changes from red to blue. "
           "Keep the simple light grey background and beige ground. Continuous static camera shot.",
    image_urls=["https://ваш-хостинг-изображений/first.png", "https://ваш-хостинг-изображений/last.png"],
    duration=5, aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Первый кадр плюс последний: пусть камера остановится на нужной картинке

Передайте в image_urls две картинки: первая — первый кадр, вторая — последний. В примере ниже первый кадр — красная машина слева, последний — синяя машина справа:

Первый кадр	Последний кадр

A toy car moves smoothly from the left to the right and changes from red to blue. Keep the simple light grey background and beige ground. Continuous static camera shot.

Сгенерировать с этим промптом → (загрузите первый и последний кадры, выберите 5 секунд, 9:16)

kling-2.5-turbo/image-to-video, 9:16, 1080×1920, 5 секунд, первый + последний кадр, $0.30.

Машина едет вправо, по пути цвет меняется с красного на фиолетовый, затем на синий, и в конце она останавливается на позиции последнего кадра, фон всё время неизменен. Если две картинки отличаются только тем, что должно измениться, результат самый стабильный. С последним кадром можно выбрать только 16:9, 9:16 или 1:1.

Таблица параметров

Поле	Обязательно	Значения	Описание
prompt	Да	1–2500 символов	Описывайте действие и камеру; для изображение-в-видео не нужно описывать картинку
duration	Нет	5 (по умолчанию) / 10	Оплата по секундам
aspect_ratio	Нет	Текст-в-видео: 16:9 (по умолчанию) 9:16 1:1; изображение-в-видео дополнительно 4:3 3:4 21:9	С последним кадром только 16:9 9:16 1:1
image_urls	Обязательно для изображение-в-видео	1–2 изображения, jpeg/png/webp, каждое ≤10MB	1-е — первый кадр, 2-е — последний кадр; текст-в-видео не принимает это поле
negative_prompt	Нет	Текст-в-видео ≤2500, изображение-в-видео ≤2496 символов	То, чего не должно быть
cfg_scale	Нет	0–1, по умолчанию 0.5	Чем больше, тем точнее следует промпту

Нет resolution, seed и переключателя звука.

Ошибки, с которыми вы столкнётесь

При неверных параметрах при отправке интерфейс сразу возвращает 400, задача не создаётся, деньги не списываются:

• duration: value must be one of 5, 10: длительность только 5 и 10.
• aspect_ratio: value must be one of '16:9', '9:16', '1:1': для текст-в-видео передано другое соотношение сторон, или для изображение-в-видео с последним кадром выбрано 4:3, 3:4, 21:9.
• image_urls: maxItems: got 3, want 2: максимум две картинки — первый плюс последний кадр.
• image_urls: missing required field "image_urls": для изображение-в-видео не передан первый кадр.
• cfg_scale: maximum: got 5, want 1: cfg_scale от 0 до 1, а не привычные для других моделей 1–20.
• additional properties 'seed', 'sound' not allowed: этих полей не существует.

Что учесть перед запуском в продакшен

• Используйте callback вместо опроса: на верхнем уровне запроса (на одном уровне с input) добавьте "callback": {"url": "https://ваш-домен/hiapi/callback"} и дедуплицируйте по taskId.
• Своевременно сохраняйте: output[0].url перестаёт работать примерно через 7 дней, сразу после получения сохраняйте в собственное хранилище.
• Явно указывайте duration и aspect_ratio: если не указать, будет 5 секунд и 16:9; для вертикального видео это легко упустить.
• При повторных попытках используйте идемпотентный ключ: добавьте в заголовки Idempotency-Key, по одному ключу создаётся только одна задача.

Частые вопросы

Можно ли отключить звук в текст-в-видео?

Нет, переключателя звука нет. Если звук не нужен, удалите дорожку при монтаже или используйте изображение-в-видео — там звуковой дорожки изначально нет.

Что будет, если соотношение сторон первого кадра в изображение-в-видео не совпадает с выбранным?

Первый кадр будет обрезан по центру под выбранное соотношение. Если выбрать 9:16 для картинки 16:9, останется центральная вертикальная полоса — размещайте главный объект по центру, так надёжнее всего.

Можно ли получить 4K?

Нет. Выход около 1080p в зависимости от соотношения сторон, самое широкое — 21:9, 2200×940.

Как выбрать между ним и Kling 3.0 Turbo?

Если достаточно 5 или 10 секунд и нужна минимальная цена — выбирайте Kling 2.5 Turbo; если нужно выбирать от 3 до 15 секунд посекундно или выбирать между 720p и 1080p — смотрите сравнение Kling 2.5 Turbo и 3.0 Turbo.

Подробности о ценах — в статье Цены Kling 2.5 Turbo API, больше сценариев — в Сборнике промптов для Kling 2.5 Turbo. Хотите сначала посмотреть результат — скопируйте промпт про гончара выше и сгенерируйте первое видео на странице модели.