У Kling O3 по API два режима, и формат ролика они задают по-разному: из текста ориентацию выбирает параметр aspect_ratio, из картинки — сам кадр. Секунда 720p без звука стоит $0,084, секунда 4K — почти впятеро больше. Ошибку 429 на пачку задач мгновенный повтор не снимет: Kling ограничивает число одновременных генераций, и каждый ролик держит слот до конца рендера.
Что такое Kling O3 и какая часть Omni доступна по API
Kling O3 — короткое имя модели Kling 3.0 Omni. В API Kling она появилась 25 февраля 2026 года, нативный 4K добавили 23 апреля (журнал изменений Kling). Слово Omni значит, что в одну модель собраны генерация из текста, анимация кадра, референсы персонажей и правка готового видео.
Через altrouter модель вызывается как kling-o3 в OpenAI-совместимом /v1/videos, и доступна только часть Omni: ролик из текста и ролик из первого кадра. Референс-картинок, элементов, последнего кадра и правки видео в нашем каталоге нет. Если без них не обойтись, остаётся прямой API Kling.
| Параметр | Значения | По умолчанию |
|---|---|---|
seconds (синоним duration) | целое число от 3 до 15 | 5 |
resolution | 720p, 1080p, 4k | 720p |
aspect_ratio | 16:9, 9:16, 1:1 | 16:9 |
sound | true или false | false |
image | ссылка или base64 первого кадра, в примерах — массив из одного элемента | нет |
Диапазоны совпадают с документацией Kling 3.0 Omni: 3–15 секунд, 720p, 1080p и 4K, три формата кадра.
28 октября Kling открыла в API версию 4.0: до 30 секунд за прогон, форматы 21:9 и adaptive, до 10 опорных кадров (журнал изменений). Секунда 720p у неё стоит $0,157 против $0,084 у O3 (прайс Kling). На 29.10.2026 Kling 4.0 в нашем каталоге нет.
Ориентацию ролика из текста задаёт aspect_ratio, из картинки — кадр
В запросе из текста формат передаётся явно: aspect_ratio со значением 16:9, 9:16 или 1:1. Если параметр не передать, ролик выйдет горизонтальным, 16:9.
С картинкой правило другое. В документации Kling 3.0 Omni сказано, что aspect_ratio обязателен, только когда в запросе нет первого кадра и референс-видео. Что модель делает с этим параметром, когда кадр есть, документация не уточняет. Мы такую связку не проверяли. 22.09.2026 запуск из картинки ушёл без aspect_ratio, и ролик взял ориентацию кадра.
Отсюда рабочее правило: с картинкой не рассчитывайте на aspect_ratio, готовьте кадр в нужной ориентации. Вертикальный ролик для Reels начинается с кадра 1080×1920, а не с "aspect_ratio": "9:16" поверх горизонтальной фотографии. Кадрируйте у себя: так вы заранее видите, что попадёт в ролик, а не узнаёте это из готового видео, за которое уже заплатили.

Требования Kling к кадру: JPG или PNG, каждая сторона не меньше 300 px, соотношение сторон от 1:2,5 до 2,5:1. Предел размера файла у Kling — 50 МБ в новом API и 10 МБ в старом. Какой из них действует при вызове через altrouter, мы не проверяли, поэтому держите кадр в пределах 10 МБ.
Цена: секунды умножаются на тариф разрешения и звука
Kling считает видео в единицах пакета за секунду готового ролика и в прайсе сразу переводит их в доллары. В таблице прайс Kling 3.0 Omni на 29.10.2026 для режима без референс-видео и наши цены по каталогу на 27.10.2026.
| Режим | Kling, $ за секунду | altrouter, $ за секунду | 5 секунд у нас | 15 секунд у нас |
|---|---|---|---|---|
| 720p без звука | 0,084 | 0,084 | $0,42 | $1,26 |
| 720p со звуком | 0,112 | 0,108 | $0,54 | $1,62 |
| 1080p без звука | 0,112 | 0,108 | $0,54 | $1,62 |
| 1080p со звуком | 0,14 | 0,138 | $0,69 | $2,07 |
| 4K, со звуком и без | 0,42 | 0,402 | $2,01 | $6,03 |
Расчёт: длина в секундах × ставка. Ролик на 10 секунд в 1080p со звуком обойдётся в 10 × $0,138 = $1,38.
В базовом режиме, 720p без звука, наша цена совпадает с ценой Kling, скидки нет. В остальных строках каталог на 1,4–4,3% ниже официальной цены вендора: у 4K $0,402 против $0,42. Цены в каталоге помечены как ориентировочные, а сколько списано за конкретный ролик, видно в логах кабинета.

Сильнее всего цену двигает разрешение: 4K дороже 720p в 4,8 раза. Звук или переход на 1080p добавляют к базовой ставке по 29%, так что секунда 1080p без звука стоит столько же, сколько секунда 720p со звуком. Подбирать промпт выгоднее на трёхсекундных черновиках в 720p. Такой ролик стоит $0,252, восемь черновиков — $2,02, почти как один финальный ролик на 5 секунд в 4K за $2,01.
При создании задачи шлюз замораживает на балансе верхнюю оценку стоимости, а после готовности списывает фактическую сумму (лимиты и кредиты). Замороженная сумма больше итоговой: 22.09.2026 ролик kling-2.1-standard на 5 секунд заморозил $0,225, а списал $0,1875. Если денег на резерв не хватает, задача не создаётся и приходит 402. Неудавшийся рендер не стоит ничего (документация видео). Сколько стоит минута видео у других моделей, разобрано в статье о цене видео нейросетью.
Замер 22.09: 50 секунд из текста, 83 из картинки и один 429
22 сентября 2026 года мы прогнали kling-o3 в обоих режимах с одним промптом: 3 секунды, 720p, без звука. Время московское, по одному прогону на режим.
| Запуск | Отправлен | Готов | Заняло |
|---|---|---|---|
| из текста, первая попытка | около 14:51 | 429, задача не создана | — |
из картинки, без aspect_ratio | 14:51:46 | 14:53:09 | 83 с |
| из текста, повтор | 14:53:44 | 14:54:34 | 50 с |
Из картинки ролик готовился на 33 секунды дольше. По одному прогону закономерность не выведешь: время зависит от очереди. Для таймаутов в коде закладывайте минуты, а не секунды.

Первый запрос из текста вернул 429 с текстом Your call frequency is too high. Please try again later. Задача не создалась, деньги не списались. В ту минуту мы одновременно запустили пачку проверочных задач по нескольким моделям. Повтор в 14:53:44 прошёл.
У самой Kling статус 429 объединяет разные причины (коды ошибок Kling). Код 1302 — слишком частые запросы, 1303 — превышен лимит параллельных задач, 1100–1102 — проблемы с аккаунтом или кончившийся пакет. Для пакетной генерации видео ключевой код — 1303. Kling считает одновременные задачи на аккаунт и версию модели, и каждый ролик держит слот всё время генерации, включая неудачные (правила параллельности). Там же оговорено, что этот лимит считает задачи, а не запросы в секунду.
Если отправить разом больше роликов, чем есть слотов, лишние получат отказ, а повтор через секунду попадёт в те же занятые слоты. Kling советует экспоненциальную задержку от одной секунды и очередь задач. У шлюза есть и собственный лимит, 600 запросов в минуту на ключ: его 429 приходит с заголовком Retry-After, где написано, через сколько секунд повторять (лимиты). Как писать повторы, которые не продлевают блокировку, мы разбирали в статье про ошибку 429.
Код: создать задачу, пережить 429 и дождаться файла
Видео в API асинхронное. POST /v1/videos сразу возвращает объект задачи с id и статусом queued. Дальше задачу опрашивают через GET /v1/videos/{id}, пока статус не станет completed с полем url или failed с причиной в поле error (документация видео). В прогоне 22.09.2026 на kling-2.1-standard ответ на создание пришёл с HTTP 202 и сразу со статусом in_progress, поэтому цикл ниже ждёт оба промежуточных статуса.
Заголовок Idempotency-Key — метка задачи, которую вы придумываете сами. Если POST оборвался по таймауту, задача могла уже создаться, и повтор без метки запустит второй платный рендер. Повтор с той же меткой вернёт первую задачу (ошибки API).
import os import time import uuid import requests API = "https://api.altrouter.ai/v1" AUTH = {"Authorization": f"Bearer {os.environ['ALTROUTER_API_KEY']}"} def create_video(payload, attempts=5): # Одна метка на одну задачу: повтор с ней не создаст второй ролик headers = {**AUTH, "Idempotency-Key": str(uuid.uuid4())} delay = 1 for _ in range(attempts): try: r = requests.post(f"{API}/videos", headers=headers, json=payload, timeout=60) except (requests.exceptions.ConnectionError, requests.exceptions.Timeout): # Обрыв или таймаут: задача могла создаться, повторяем с той же меткой time.sleep(delay) delay *= 2 continue if r.status_code in (409, 429): # 429 — лимит, 409 — первая попытка с этой меткой ещё обрабатывается time.sleep(float(r.headers.get("retry-after", delay))) delay *= 2 continue r.raise_for_status() return r.json() raise RuntimeError("Задача не создана: уменьшите число одновременных генераций") def wait_video(job, timeout_s=900): deadline = time.monotonic() + timeout_s while job["status"] in ("queued", "in_progress"): if time.monotonic() > deadline: raise TimeoutError(f"{job['id']} не готов за {timeout_s} с") time.sleep(10) r = requests.get(f"{API}/videos/{job['id']}", headers=AUTH, timeout=30) r.raise_for_status() job = r.json() if job["status"] != "completed": raise RuntimeError(f"{job['id']}: {job.get('error')}") return job["url"] job = create_video({ "model": "kling-o3", "prompt": "A slow cinematic camera push-in, gentle natural motion, soft light", "seconds": 5, "resolution": "720p", # Ориентацию задаёт кадр, поэтому aspect_ratio здесь не передаём "image": ["https://example.com/frame-1920x1080.png"], }) print(job["id"], job["status"]) print(wait_video(job))
Для ролика из текста уберите image и добавьте "aspect_ratio": "9:16" или другой нужный формат. Таймаут в wait_video останавливает только ваш цикл. Метода отмены в документации нет, так что задача, ушедшая в рендер, продолжится без вас и при успехе будет оплачена. Сохраняйте id в базу сразу после create_video, чтобы забрать ролик и после рестарта воркера.
Если роликов много, ставьте их в очередь с ограничением на число одновременных задач, а не отправляйте одним циклом. Тогда 429 из-за параллельности не возникает, а время ожидания складывается предсказуемо.
Что мы не проверяли
Замер — по одному прогону на режим, поэтому 50 и 83 секунды нельзя считать гарантированным временем ответа. Мы не запускали 1080p, 4K, звук и ролики длиннее 3 секунд. Связку «картинка плюс aspect_ratio» не проверяли, и совет готовить кадр нужной ориентации опирается на документацию Kling и единственный запуск без этого параметра. Лимит размера кадра при вызове через altrouter тоже не проверен.
FAQ
Чем Kling O3 отличается от Kling 3.0?
Это модели одного поколения: 3–15 секунд, 720p, 1080p и 4K, звук по желанию. Omni вдобавок принимает референс-картинки, элементы и видео для правки, но через altrouter у kling-o3 доступны только текст и первый кадр. По каталогу на 27.10.2026 секунда 720p без звука у kling-o3 стоит $0,084, у kling-3.0 — $0,0875. Время и цену четырёх моделей Kling на одной задаче мы сравнили в разборе Kling 2.5 Turbo, 3.0 и O3.
Как получить вертикальный ролик из горизонтальной фотографии?
Обрежьте фотографию до 9:16 у себя и отправьте уже вертикальный кадр. Документация Kling не обещает, что aspect_ratio поменяет ориентацию, если в запросе есть первый кадр, а мы это сочетание не проверяли. Для ролика в 1080p подойдёт кадр 1080×1920: его не придётся растягивать.
Подробнее: Kling API: модели и цены.
Сколько хранится готовый ролик?
Шлюз отдаёт ссылку на свой домен, и сгенерированные файлы хранятся бессрочно (хранение данных). Прямой API Kling удаляет результаты через 30 дней после генерации (журнал изменений Kling). Если работаете с Kling напрямую, забирайте файлы к себе сразу.