Kling O3 по API: формат кадра, цена секунды и ошибка 429

10 минут чтенияобновлено

У 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 до 155
resolution720p, 1080p, 4k720p
aspect_ratio16:9, 9:16, 1:116:9
soundtrue или falsefalse
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" поверх горизонтальной фотографии. Кадрируйте у себя: так вы заранее видите, что попадёт в ролик, а не узнаёте это из готового видео, за которое уже заплатили.

Развилка: aspect_ratio для запроса из текста и формат из кадра для запроса с картинкой
С картинкой формат задаёт кадр, поэтому aspect_ratio лучше не передавать.

Требования 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,0840,084$0,42$1,26
720p со звуком0,1120,108$0,54$1,62
1080p без звука0,1120,108$0,54$1,62
1080p со звуком0,140,138$0,69$2,07
4K, со звуком и без0,420,402$2,01$6,03

Расчёт: длина в секундах × ставка. Ролик на 10 секунд в 1080p со звуком обойдётся в 10 × $0,138 = $1,38.

В базовом режиме, 720p без звука, наша цена совпадает с ценой Kling, скидки нет. В остальных строках каталог на 1,4–4,3% ниже официальной цены вендора: у 4K $0,402 против $0,42. Цены в каталоге помечены как ориентировочные, а сколько списано за конкретный ролик, видно в логах кабинета.

Шкала цены Kling O3 за секунду: официальная и наша цена совпадают, отдельно цена со звуком
Скидки на Kling O3 нет: платите ровно официальные $0,084 за секунду.

Сильнее всего цену двигает разрешение: 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:51429, задача не создана—
из картинки, без aspect_ratio14:51:4614:53:0983 с
из текста, повтор14:53:4414:54:3450 с

Из картинки ролик готовился на 33 секунды дольше. По одному прогону закономерность не выведешь: время зависит от очереди. Для таймаутов в коде закладывайте минуты, а не секунды.

Столбчатая диаграмма: время ролика Kling O3 720p на 3 секунды из текста и из картинки
Из картинки ролик шёл на 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).

Python
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 напрямую, забирайте файлы к себе сразу.

Вендоры