Как использовать API преобразования текста в видео Kling 3.0 Turbo? Параметры, код и ошибки

TL;DR

• Имя модели Kling 3.0 Turbo для преобразования текста в видео — kling-3.0-turbo/text-to-video, это быстрый вариант Kling 3.0.Откройте страницу модели и попробуйте онлайн.
• Оплата по секундам: 720p — $0.13 за секунду, 1080p — $0.16 за секунду. Длительность — любое целое число от 3 до 15 секунд, 5 секунд 720p стоят $0.65.
• Всего 4 параметра: prompt, duration, aspect_ratio, resolution. Передача любого дополнительного поля (например, seed, negative_prompt) вернёт 400.

Сначала посмотрите один пример

720p, 5 секунд, 16:9:

aerial drone shot sweeping over a norwegian fjord waterfall, mist drifting,
camera gliding forward, smooth natural motion, stable cinematic camera
movement, consistent lighting across frames, cinematic composition, dramatic
directional lighting, rich cohesive color grade, ultra-detailed, premium
commercial finish

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

kling-3.0-turbo/text-to-video, 5 секунд.

Быстрый справочник параметров

Поле	Обязательно	Значения	Описание
prompt	Да	до 2500 символов	Сцена, субъект, действие, движение камеры; реплики в кавычках синхронизируются с губами
duration	Нет	целое 3–15, по умолчанию 5	Оплата по секундам, каждая лишняя секунда стоит дополнительно
aspect_ratio	Нет	16:9 (по умолчанию) / 9:16 / 1:1	Горизонтальный, вертикальный, квадратный
resolution	Нет	720p (по умолчанию) / 1080p	Определяет цену за секунду

Нет поля sound, но готовое видео содержит звук, отключить его нельзя. Также нет 4K, последнего кадра и референсных изображений — если они нужны, используйте стандартную версию Kling 3.0 или Omni.

curl: запускаем первый запрос

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo/text-to-video",
    "input": {
      "prompt": "A golden retriever surfing a turquoise wave at sunset, cinematic slow motion, water droplets frozen mid-air",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p"
    }
  }'

В ответе только data.taskId. Опрашивайте GET /v1/tasks/{taskId} каждые 5–10 секунд, после того как status станет success, скачайте видео по output[0].url.

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(timeout_s=900, **inp):
    # при повторной отправке того же запроса используйте тот же Idempotency-Key, спишется только один раз
    r = requests.post(API, json={"model": "kling-3.0-turbo/text-to-video", "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"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(8)
    raise TimeoutError(task_id)

# вертикальный 3 секунды 720p для проверки направления, $0.39
url = generate(
    prompt="A barista pours latte art in slow motion, close-up, warm cafe light",
    duration=3, aspect_ratio="9:16", resolution="720p",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Сколько стоит

Длительность	720p ($0.13/сек)	1080p ($0.16/сек)
3 секунды (минимум)	$0.39	$0.48
5 секунд	$0.65	$0.80
10 секунд	$1.30	$1.60
15 секунд (максимум)	$1.95	$2.40

Текущие цены HiAPI, проверено 18 октября 2026 г.

За неудачные генерации плата не взимается. Полное сравнение см. в цены API Kling 3.0 Turbo.

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

Что вы передали	Ответ
Не передали prompt	400, missing required field "prompt"
Передали лишние поля (например, seed, negative_prompt)	400, additional properties ... not allowed
duration: 2	400, duration: minimum: got 2, want 3
duration: 99	400, duration: maximum: got 99, want 15
aspect_ratio: "4:3"	400, допускается только 16:9, 9:16, 1:1
resolution: "480p"	400, допускается только 720p, 1080p
Неверный или отсутствующий ключ	401, permission_denied
Недостаточно средств	402, сначала пополните баланс, затем разбирайтесь

Ошибки параметров возвращаются синхронно при отправке; сбой генерации обнаруживается позже при опросе, когда status равен fail, ошибка находится в data.error. Нужно обрабатывать оба случая.

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

• Используйте callback вместо опроса: на одном уровне с input добавьте "callback": {"url": "https://your-app.example.com/hiapi/callback", "when": "final"}, по завершении задача уведомит один раз, дедуплицируйте по taskId.
• Передавайте заголовок Idempotency-Key: при повторной попытке после тайм-аута используйте тот же ключ, будет создана только одна задача и списание произойдёт один раз.
• Скачивайте результат сразу: output[0].url имеет срок действия.
• Больше 15 секунд — разбивайте на части: передайте последний кадр предыдущего видео в kling-3.0-turbo/image-to-video как первый кадр и продолжайте генерацию.

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

Сколько времени занимает одна генерация?

Считается минутами: чем длиннее видео и выше разрешение, тем дольше. Рекомендуемый лимит опроса — 10–15 минут, либо сразу используйте callback.

Поддерживаются ли негативные промпты?

Нет. То, чего нужно избежать, пишите прямо в промпт, например «no text overlays, no watermarks».

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

Turbo — скоростной вариант со встроенным звуком; стандартная версия без звука в 720p дешевле — $0.10 за секунду, звук можно включать и отключать, также доступно 4K. Сравнение на одном промпте см. в Kling 3.0 Turbo vs Kling 3.0.

Скопируйте промпт про фьорд выше и сгенерируйте 3-секундный тест за $0.39.