Как использовать API Kling 3.0? Руководство на китайском по генерации видео из текста и изображений

TL;DR

• Kling 3.0 — видеомодель от Kuaishou; на HiAPI доступны два эндпоинта: генерация видео из текста kling-3.0/text-to-video и из изображения kling-3.0/image-to-video. Длительность ролика 3–15 секунд, максимальное разрешение 4K, поддерживается нативный звук. Откройте страницу модели, чтобы генерировать онлайн; новым пользователям при регистрации начисляется 200 кредитов.
• Оплата по секундам: 720p — $0.10 за секунду, со звуком $0.143; 1080p — $0.129, со звуком $0.193; 4K — $0.479. 5 секунд в 720p стоят всего $0.50.
• API в два шага: отправьте задачу через POST /v1/tasks и получите taskId для проверки результата. Примеры на curl и Python ниже можно скопировать и запустить.

Сначала посмотрите результат

Генерация видео из текста: один английский промпт, один запрос.

A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.

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

Пример на странице модели kling-3.0/text-to-video, 5 секунд. В 720p без звука — $0.50, в 1080p со звуком — $0.965.

Генерация видео из изображения: используйте это изображение маяка как первый кадр.

The waves surge and crash against the rocks, the lighthouse beam sweeps slowly across the stormy night sky, rain streaks through the wind. Smooth cinematic motion, synchronized ambient sound of waves and storm.

Сгенерировать с этим промптом → (загрузите своё изображение первого кадра, 5 секунд)

Пример на странице модели kling-3.0/image-to-video, 5 секунд. В 720p со звуком — $0.715.

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

На HiAPI у Kling 3.0 три линейки с разными названиями моделей, ценами и параметрами:

Модель	Эндпоинт	720p / сек	1080p / сек	4K / сек	Для чего
Kling 3.0 kling-3.0/*	Из текста, из изображения (первый кадр или первый и последний)	$0.10, со звуком $0.143	$0.129, со звуком $0.193	$0.479	Ролики со звуком, многокадровые короткометражки
Kling 3.0 Omni kling-3.0-omni/*	Из текста, из изображения, из референса, переработка видео	$0.10, со звуком $0.129	$0.129, со звуком $0.1645	$0.479	Фиксация персонажа/товара, движение камеры по референсному видео
Kling 3.0 Turbo kling-3.0-turbo/*	Из текста, из изображения	$0.13	$0.16	—	Без разделения по звуку, цена только по разрешению

Если нужны только генерация из текста и из изображения, выбирайте kling-3.0; если нужно зафиксировать объект по референсному изображению, использовать референсное видео или переработать существующее видео, смотрите руководство по Kling 3.0 Omni на китайском.

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

Онлайн-тестирование (без кода)

1. Откройте страницу модели Kling 3.0 для генерации видео из текста, зарегистрируйтесь или войдите.
2. Вставьте промпт, выберите длительность, разрешение, соотношение сторон и решите, нужен ли звук.
3. Нажмите «Сгенерировать» и скачайте готовое видео.

Вызов через API

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

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

5 секунд, 720p, без звука — $0.50:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0/text-to-video",
    "input": {
      "prompt": "金色夕阳下，一只红狐在风雪覆盖的山脊上疾奔，雪粉飞扬，电影级侧光，平滑跟拍",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "sound": false
    }
  }'

Ответ:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Проверка результата:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: отправка, опрос, загрузка

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(model, timeout_s=900, **params):
    body = {"model": model, "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{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)

# 竖屏、带声音的口播短视频
url = generate(
    "kling-3.0/text-to-video",
    prompt="竖屏短视频：一位博主拿着新耳机对着镜头介绍，手势自然，室内自然光，口型和说话声同步",
    duration=6, resolution="1080p", aspect_ratio="9:16", sound=True,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Это видео длительностью 6 секунд в 1080p со звуком стоит $1.158.

Генерация из изображения: один первый кадр или первый и последний

Замените название модели на kling-3.0/image-to-video и передайте изображения в image_urls: 1 изображение — первый кадр, 2 изображения — [первый кадр, последний кадр].

{
  "model": "kling-3.0/image-to-video",
  "input": {
    "image_urls": [
      "https://your-cdn.example.com/start.jpg",
      "https://your-cdn.example.com/end.jpg"
    ],
    "prompt": "镜头缓慢推进，两个画面之间平滑过渡",
    "duration": 5,
    "resolution": "720p",
    "sound": false
  }
}

• Поддерживаются изображения JPEG / PNG / WebP, SVG не поддерживается.
• При генерации из изображения нет aspect_ratio — соотношение сторон берётся из первого кадра.
• Промпт необязателен: опишите, «что должно происходить дальше», не нужно заново описывать всё изображение.

Обзор параметров

Параметр	Значения	Описание
prompt	Строка	Обязателен для генерации из текста, опционален для генерации из изображения
image_urls	1–2 изображения	Только для генерации из изображения; 1 изображение — первый кадр, 2 — первый и последний кадры
duration	Целое от 3 до 15, по умолчанию 5	В секундах
resolution	720p / 1080p / 4K, по умолчанию 1080p	Если не указан, оплата по 1080p
aspect_ratio	16:9 / 9:16 / 1:1, по умолчанию 16:9	Только для генерации из текста
sound	По умолчанию false	При включении генерируются диалоги, звуковые эффекты и атмосферный звук

Посчитаем стоимость

Длительность	720p	720p со звуком	1080p	1080p со звуком	4K
3 секунды	$0.30	$0.429	$0.387	$0.579	$1.437
5 секунд	$0.50	$0.715	$0.645	$0.965	$2.395
10 секунд	$1.00	$1.43	$1.29	$1.93	$4.79
15 секунд	$1.50	$2.145	$1.935	$2.895	$7.185

resolution по умолчанию — 1080p; при настройке промпта не забудьте явно указать 720p — это сэкономит более 20%. Больше сравнений цен смотрите в статье Цены API Kling 3.0.

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

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

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

Можно ли писать промпт на китайском?

Да. Можно на китайском и английском; реплики диалогов также можно писать прямо в промпте.

Нужно ли платить за звук отдельно?

При sound: true цена за секунду выше: для 720p — с $0.10 до $0.143, для 1080p — с $0.129 до $0.193. Если нужна только картинка, оставьте значение по умолчанию false.

Какая максимальная длительность одного ролика?

3–15 секунд. Более длинные ролики генерируйте по частям и затем монтируйте.

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

У Kling 3.0 ниже цена за секунду и есть поддержка 4K; Seedance 2.5 генерирует ролики длительностью до 30 секунд. Сравнение смотрите в статье Различия Kling 3.0 и Seedance 2.5.

Хотите готовые формулировки — смотрите руководство по промптам Kling 3.0; также можно скопировать промпт про красную лису выше и сгенерировать на странице модели.