Ролик из нескольких сцен одним запросом: как подключить Kling API из России

Kling 3.0, версии до 1.6 и Kling Motion работают по API под одним ключом CyHUB, оплата в рублях. В тройке ролик до 15 секунд делится на сцены одним флагом, и монтировать куски потом не нужно. Звук модель пишет вместе с видео, но русской речи в её списке языков нет.

Для ключа нужна подтверждённая почта, после этого он создаётся в кабинете CyHUB. Пошагово, со скриншотами входа, ключей и пополнения, - в гайде по API.

Модель в API называется kling_pro, а версию задаёт model_version внутри settings: v3.0, v2.6, v2.5t, v2.1m, v2.1 или v1.6.

Генерация обычно идёт 3-5 минут. Статус спрашиваете через GET /v1/tasks/{id}, а готовый MP4 скачиваете по download_path тем же ключом, хранится он 7 дней. Цена растёт с каждой секундой, с 4K и с озвучкой, поэтому перед длинным роликом прогоните настройки через POST /v1/price: он считает, но не списывает.

Обвязку на вашем стеке соберёт ИИ-агент. Отдайте Cursor, Claude Code или Codex ссылку api.cyhub.ai/models/kling-3/api.md - там поля и примеры всех режимов.

• length - от 3 до 15 секунд, по умолчанию 5.

• quality - 720p по умолчанию, 1080p или 4K.

• aspect_ratio - 16:9, 1:1 или 9:16. С первым или последним кадром ролик берёт пропорции самого кадра.

• native_audio - голоса, звуки и музыка под содержание видео. Включена по умолчанию и стоит дороже, для немого ролика ставьте false.

• prompt - до 5000 знаков: действие, движение камеры, настроение сцены.

Флаг "multi_shot": true делит ролик на сцены, а описание на планы модель режет сама. Сцены удобнее писать по порядку, через «сначала» и «потом»:

Если же всё-таки склеиваете отдельные генерации, не сшивайте их на живую нитку простым копированием потоков. У файлов бывает разный порядок дорожек, и такая склейка молча обрывается на первом куске. Перекодируйте при склейке.

Кадры идут в start_frame и end_frame, по одной ссылке в списке. В тройке последний кадр работает и без первого. Подойдёт JPG или PNG до 10 МБ, сторона не меньше 300 пикселей, пропорции от 1:2,5 до 2,5:1, а ссылка должна вести прямо на файл, без переадресации.

У старых версий есть ограничения, которых в карточках не видно. У 2.6 озвучка работает только в 1080p, а последний кадр - только вместе с первым и без озвучки. У 2.1 первый кадр обязателен, а 2.1 Master последнего кадра не принимает вовсе.

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

Главная ловушка здесь - версия. По умолчанию model_version стоит 2.6, а 3.0, которая точнее передаёт сложные движения и лицо, включается только явным "3.0". Поле quality выбирает std (720p) или pro (1080p).

На фото голова и тело должны быть видны и ничем не закрыты, а персонаж стоять в кадре так же, как человек в видео: по пояс или целиком. Видео лучше с одним человеком, одним планом, без склеек и движения камеры: MP4 или MOV до 100 МБ, от 3 до 30 секунд. С "orientation": "image" кадр держится как на фото, но видео тогда не длиннее 10 секунд.

Звук из видео с движениями по умолчанию остаётся в ролике (with_audio). Прослушайте референс целиком ещё до нарезки, иначе чужая речь уедет в готовый ролик. Цена считается за каждую секунду видео с движениями, так что лишнее обрежьте заранее. Готовый ролик бывает короче: Kling берёт только те движения, которые распознал.

По руководству Kling реплику на неподдерживаемом языке модель переводит на английский, а русского в списке языков озвучки нет. Короткую фразу можно попробовать транслитом латиницей. Для длинного текста надёжнее записать голос в ElevenLabs через тот же ключ, а губы подогнать моделью HeyGen Lip Sync из того же каталога.

• «С озвучкой модель 2.6 работает только в качестве 1080p» - поднимите quality или выключите native_audio.

• «Последний кадр доступен только при загруженном первом» - у 2.6 последний кадр принимается только вместе с start_frame.

• 422 unknown_setting - поле, которого у модели нет. Скажем, length в запросе к kling_motion: там длину задаёт видео с движениями.

• 503 model_unavailable - модель на обслуживании. Заранее это видно по полю available в GET /v1/models.

Kling запускается и без кода - в чате Claude или ChatGPT через плагин MCP. Ключ API там не нужен, тратится тот же баланс. Подключение плагина в ChatGPT и в Claude.

Нужен ли аккаунт Kling? Нет, хватает ключа CyHUB: подписку Kling оформлять не нужно.

Сколько ждать? Обычный ролик - 3-5 минут, Kling Motion - 5-10. Опрашивать статус чаще раза в несколько секунд ведь смысла нет.

Спишутся ли деньги за упавшую генерацию? Нет. Цена резервируется при приёме задачи и списывается только после succeeded, а при ошибке возвращается на баланс.

Все версии Kling, Motion, документация и остальные видеомодели - в каталоге CyHUB. А вы Kling по API под что подключаете: ролики для соцсетей, рекламу или свой сервис?

#нейросети #api #kling