Kling API в России

Kling AI в России: как купить доступ к Kling API

Доступ к Kling AI продаём мы, а не Kuaishou. Шагов три: войти, пополнить баланс и создать ключ в кабинете.

Платят рублями с карты российского банка; долларового счёта у Kuaishou заводить не надо. Ролик тарифицируется за секунду: секунда стоит от 7,56 ₽ до 37,8 ₽, и место в этой вилке задаёт разрешение.

Кредиты покупаются пакетами от 500 ₽ за 1 000 кредитов. Перед запуском часть кредитов резервируется: столько, во сколько обойдётся заказанная длительность в выбранном разрешении. Лишнее вернётся на баланс, как только поставщик ответит.

Обе страницы семейства оплачиваются с одного баланса: и съёмка ролика, и перенос движения. Помесячного платежа за доступ здесь нет — деньги уходят за поставленные задачи. Кредиты появляются на счёте сразу после оплаты, и включать доступ к записям не требуется.

Чем Turbo отличается от старшей записи Kling

Kuaishou описывает Kling 3.0 тремя вещами: родной звук, удержание одних и тех же персонажей и предметов от кадра к кадру и рассказ, собранный из нескольких кадров. Turbo он подаёт как более быстрый вариант с тем же ровным результатом.

Разрешение 4K осталось за Kling 3.0: у Turbo выбор между 720p и 1080p. Ещё у Turbo нет работы по последнему кадру и нет закрепления персонажа — так пишет сам разработчик.

Длительность у них одна: от 3 до 15 секунд. Что кладётся в запрос, разобрано в разделе «Kling».

Записи Kling API: чем они различаются полями запроса

Записей у семейства 4: Kling 3.0, Kling 3.0 Motion Control, Kling 3.0 Turbo text-to-video и Kling 3.0 Turbo image-to-video. Старшая берёт обе свои работы под одним именем: ролик по описанию и ролик от присланного кадра. У Turbo под каждую работу заведена своя запись, и в поле model у них разные имена.

Отрезок длительности у генерации общий — от 3 до 15 секунд. Разрешение у Kling 3.0 выбирают полем mode: значение std означает 720p, pro — 1080p, а 4K названо прямо. У Turbo под то же самое отведено поле resolution со значениями 720p и 1080p.

Родной звук у Kling 3.0 включается флагом sound, и на цену он влияет наравне с разрешением. Исходный кадр приходит ссылкой: список image_urls берёт до 2 ссылок. У записи Kling 3.0 Turbo image-to-video эта ссылка объявлена обязательной, и запрос без неё дальше шлюза не уйдёт. На той стороне неполный набор кадров принимают и роняют уже в работе, поэтому проверка на постановке экономит время.

Перенос движения устроен иначе: у Kling 3.0 Motion Control поля длительности нет вовсе. Сколько секунд получится, приносит присланный ролик, а не число в запросе. Разрешение здесь тоже лежит в поле mode, но значения у него другие — 720p и 1080p.

Описание у Kling 3.0 вмещает до 20 000 знаков, у Turbo — до 2 500. Кадр и исходный ролик передаются полным адресом на http или https, открытым снаружи. Файл с диска превращает в такой адрес загрузка — она разобрана в разделе «Загрузка своих файлов».

Что нужно, чтобы получить ключ к Kling API

Хватит входа на сайт: дальше ключ создаётся в кабинете и работает сразу. Отдельного доступа к видеомоделям не выдают — ключ один на все виды работ.

Ключей заводят столько, сколько нужно, и каждому дают имя не длиннее 60 знаков. Тем же ключом вызывается весь каталог, включая картинки и языковые модели.

Отзывается ключ там же, где выпущен, и остальные ключи счёта после этого работают дальше. Расход по каждому из них виден в кабинете отдельной строкой на каждый запуск.

У самого разработчика запрос к API подписывают, и подпись эта живёт ограниченное время. Поэтому «ключ не принят» там чаще означает просроченную подпись, а не испорченный ключ. Здесь подписывать нечего: в заголовок идёт сам ключ, и срока годности у него нет.

Порядок вызова Kling API: постановка задачи и опрос по номеру

Готовое видео в ответ на первый запрос не возвращается: съёмка длится дольше, чем держится соединение. Поэтому команд две. Первая ставит задачу: POST на https://api.gen202.com/api/v1/jobs/createTask. В ответе на неё лежит один taskId — номер, по которому дальше и спрашивают.

1. Первая команда. POST на https://api.gen202.com/api/v1/jobs/createTask: имя записи в поле model, остальное — по её набору полей.
2. Ответ на неё. Приходит один taskId, и работа с этого места идёт по номеру, а не по самому запросу.
3. Вторая команда. GET на /api/v1/jobs/recordInfo с номером в строке запроса; состояние опрашивайте раз в 3 секунд.
4. Поле state. Слова waiting и queuing означают очередь, generating — что съёмка идёт, success и fail — что она кончилась.
5. Ссылка на ролик. Адрес лежит внутри поля resultJson, которое передаётся строкой и разбирается ещё раз тем же разбором JSON.

Открывается адрес 14 дней: столько готовый файл хранит поставщик. Ключ уходит в обеих командах заголовком Authorization, и выпускается он в кабинете. Крайний срок задачи у видео — 60 минут, после чего шлюз закрывает её сам.

Частота считается на ключ: 30 постановок и 300 опросов в минуту. Одновременно на счёте держится до 50 незакрытых задач, дальше постановка ждёт. Оба потолка вместе с прочими правилами работы разобраны в разделе «Лимиты и эксплуатация».

Как считается расход на Kling и почему сумма замирает на счёте

Единица счёта здесь — секунда готового ролика, и сумма выходит умножением ставки на длительность. Ставку у Kling 3.0 двигают разрешение и звук, у Turbo — одно разрешение. По семейству вилка идёт от 7,56 ₽ до 37,8 ₽ за секунду.

До запуска нужная сумма откладывается: свободной она быть перестаёт, но со счёта ещё не уходит. Когда ролик готов, шлюз списывает фактический расход и отпускает остаток отложенного. Сколько ушло по этой задаче, приходит числом в поле creditsConsumed рядом со ссылкой.

У Kling 3.0 Motion Control длительность в запросе не называется, и посчитать её заранее нечем. Под такую задачу откладывается предел записи — 1814,5 ₽, то есть 120 секунд по дорогой ставке. Списывается из них только то, во что обошёлся присланный ролик, остальное возвращается.

Свободных кредитов меньше отложенной суммы — задача не заводится, и приходит отказ 402. Под короткий ролик в 720p откладывается меньше, поэтому он проходит и на скромном остатке. Правило расчёта целиком разобрано в разделе «Баланс и расход».

Отказы Kling API: что приходит в ответ и сколько это стоит

Отказ приходит либо сразу на команду, либо позже — вместе с состоянием задачи. Всё, что шлюз отбивает у себя, не стоит ни кредита: до Kuaishou такой запрос не доходит.

• 401 — ключа в заголовке нет либо он неверный или отключённый.
• 422 — неизвестное имя записи, значение вне списка или пропущенная обязательная ссылка.
• 402 — свободных кредитов меньше суммы, откладываемой под заказанную длительность.
• 413 — тело запроса тяжелее 512 КиБ.
• 415 — тело обеих команд принимается только как JSON.
• 429 — превышена частота либо упёрся счёт незакрытых задач.
• 404 — задачи с таким номером нет или она заведена другим счётом.

Ссылки на кадр и на исходный ролик шлюз разбирает у себя: схему, длину и то, куда адрес ведёт. Неудача самой съёмки приходит иначе: запрос состояния успешен, а причина лежит в поле failCode. Код 501 ставится, когда Kuaishou вернул отказ на генерацию, а 408 — когда результата нет дольше крайнего срока.

Код 429 означает, что поставщик отбил задачу своим лимитом, а 404 — что он её не знает. Отложенное под неудавшуюся задачу возвращается полностью, и в creditsConsumed у неё остаётся ноль. Полный перечень отказов вместе с разбором стоит в разделе «Отказы».

Место под задачу занято с момента постановки и до самого конца, неудачей она кончилась или успехом. Освобождается оно сразу, как только задача закрылась, а запросы состояния его не занимают вовсе. Поэтому опрашивать готовность можно свободно, а вот ставить новые задачи пачкой упирается в тот же потолок.

Нужен ли ключ Kuaishou, чтобы вызвать Kling

Нет. Ни ключа Kuaishou, ни учётной записи в Kling AI у вас не спросят: к поставщику обращается наш шлюз своим ключом.

Можно ли купить у нас API ключ Kling AI

Ключи Kuaishou выдаёт только он сам. Продаём мы секунды готового видео — по нашему ключу и нашему адресу.

Свой ключ вы выпускаете сами, а невыработанные кредиты остаются в кабинете.

Есть ли бесплатный доступ к Kling API

Съёмка оплачивается посекундно, и первые секунды закрывают приветственные кредиты. При первом входе начисляется 50 кредитов — по самой низкой ставке семейства это 3 секунды готового ролика.

Форма запроса и сумма удержания видны до запуска — в песочнице. Дальше платят только за заказанное, а задача с ошибкой возвращает удержание целиком.

Что умеет управление движением в Kling и чего не умеет

Эта запись переносит движение и мимику с готового ролика на человека с картинки. В запрос обязательно идут оба файла — и ролик, и картинка.

Kuaishou называет и границы: работает модель с одним главным человеком в кадре, речь и совпадение губ не делает, а если движение и картинка сильно расходятся — например, движение человека переносят на животное, — результат портится. Разрешение здесь 720p или 1080p, а секунда стоит от 11,34 ₽.

Работать из России можно без VPN, а платить — рублями с карты российского банка. Прямой доступ идёт через биллинг поставщика, и счёт он выставляет в долларах. GEN202 стоит между вами и поставщиком: расчёты с ним наши, вы платите российскому продавцу.

Kling — семейство видеомоделей Kuaishou. Кроме обычной генерации ролика у него есть перенос движения — работа, которой у соседних поставщиков нет.