Kling 3.0
Kling 3.0 — семейство видеомоделей: реалистичное движение и сцены из текста или стартового кадра, со звуком. Два тира с одинаковыми параметрами: Standard (kwaivgi/kling-v3.0-std) — баланс цены и качества, и Pro (kwaivgi/kling-v3.0-pro) — высокое качество движения и детализации. Генерация асинхронная: POST /v1/videos возвращает задачу, дальше опрос статуса и скачивание mp4.
Параметры
Заголовок раздела «Параметры»| Поле | Описание |
|---|---|
model |
kwaivgi/kling-v3.0-std или kwaivgi/kling-v3.0-pro (короткие kling-v3.0-std / kling-v3.0-pro; псевдоним kling = Pro) |
prompt |
Описание сцены, обязательное |
seconds |
Одно из значений 5, 10, 15; по умолчанию 5 |
size |
Один из трёх размеров ниже; по умолчанию 1280x720 |
input_reference |
Image-to-video: одна картинка как стартовый кадр, {"image_url": "data:image/...;base64,..."} |
input_references |
Не поддерживается: references у моделей false, запрос с массивом вернёт 400 |
seed |
Не поддерживается: seed у модели false, запрос с этим полем вернёт 400 |
Все три размера — 720p и различаются только форматом кадра:
| Соотношение | Размер |
|---|---|
16:9 |
1280x720 |
9:16 |
720x1280 |
1:1 |
720x720 |
Примеры
Заголовок раздела «Примеры»Генерация по тексту
Заголовок раздела «Генерация по тексту»import requests
job = requests.post( "https://api.mixen.ai/v1/videos", headers={"Authorization": f"Bearer {API_KEY}"}, json={ "model": "kwaivgi/kling-v3.0-std", "prompt": "Танцор в яркой панаме исполняет брейк-данс на бетонной площадке, длинная тень от закатного солнца", "seconds": "10", "size": "1280x720", },).json()print(job["id"], job["status"])curl https://api.mixen.ai/v1/videos \ -H "Authorization: Bearer $MIXEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "kwaivgi/kling-v3.0-std", "prompt": "Танцор в яркой панаме исполняет брейк-данс на бетонной площадке, длинная тень от закатного солнца", "seconds": "10", "size": "1280x720" }'Image-to-video по стартовому кадру
Заголовок раздела «Image-to-video по стартовому кадру»Картинка передаётся одной строкой data:-URL — внешние ссылки не принимаются:
import base64import requests
with open("portrait.jpg", "rb") as f: img = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
job = requests.post( "https://api.mixen.ai/v1/videos", headers={"Authorization": f"Bearer {API_KEY}"}, json={ "model": "kwaivgi/kling-v3.0-pro", "prompt": "Портрет оживает: взгляд уходит в сторону, лёгкая улыбка, шевелятся волосы", "seconds": "5", "size": "1280x720", "input_reference": {"image_url": img}, },).json()print(job["id"], job["status"])Опрос и скачивание
Заголовок раздела «Опрос и скачивание»curl https://api.mixen.ai/v1/videos/video_... \ -H "Authorization: Bearer $MIXEN_API_KEY"
curl -L https://api.mixen.ai/v1/videos/video_.../content \ -H "Authorization: Bearer $MIXEN_API_KEY" \ -o kling.mp4Статусы: queued → in_progress → completed либо failed. Разумный интервал опроса — 5–10 секунд. Детали цикла — гайд по видео.
Оба тира тарифицируются посекундно, ставка от формата кадра не зависит: Standard — 16.8453 ₽ ($0.189) за секунду, Pro — 22.4604 ₽ ($0.252). Списывается длительность × ставка тира. Актуальные цены — каталог.
Сильные стороны и ограничения
Заголовок раздела «Сильные стороны и ограничения»- Реалистичное движение и сцены из текста или кадра — профиль семейства; звук уже в готовом ролике.
- Два тира под задачу: Standard для обычных сцен, Pro — когда нужна максимальная детализация движения.
- Три формата кадра: альбомный, вертикальный и квадратный.
- Только 720p: разрешений 480p и 1080p у семейства нет.
- Длительности фиксированные: только 5, 10 или 15 секунд — непрерывного ряда, как у Seedance, нет.
- Reference-to-video не поддерживается; картинку можно передать лишь как стартовый кадр
input_reference.
Все модели — в каталоге. Общий порядок работы с видео — гайд по видео.