Масштабирование генерации ИИ-видео: пакеты, вебхуки и контроль затрат

Цена видео в Nureta Developer API линейна, поэтому стоимость — это секунды × ставка. seahorse-480p: $0.1888 за секунду, $0.944 за 5 секунд. seahorse-720p: $0.2773 за секунду, $1.3864 за 5 секунд. seahorse-1080p: $0.5428 за секунду, $2.7139 за 5 секунд. Одиночные клипы длятся 5, 8, 10, 12 или 15 секунд; склеенные многокадровые видео — любое целое число секунд от 16 до 180 по той же ставке. Сценарий стоит фиксированные $0.01, изображение — $0.05. Публичный эндпоинт GET /api/v3/models возвращает актуальные цены, так что берите ставки оттуда, а не зашивайте в код.

Это цены API, а не приложения. Потребительское приложение на nureta.ai берёт $1.29 за 5-секундное видео, то есть 2 кредита за секунду, что на пакете за $39.99 даёт около $0.91 за 5 секунд. В приложении есть бесплатное первое видео и готовый интерфейс в 480p; API — это продукт для разработчиков с оплатой по факту, 720p и 1080p и списанием с предоплаченного баланса. Рассматривайте их как разные продукты по разным ценам.

Расчёты по прайсу. Один фильм на 60 секунд: $11.33 в 480p, $16.64 в 720p, $32.57 в 1080p. Один фильм на 180 секунд в 480p: $33.98. Пакет из 100 клипов по 15 секунд в 480p: 1 500 секунд × $0.1888 = $283.20; тот же пакет стоит $415.95 в 720p и $814.20 в 1080p. 100 сценариев раскадровки: $1.00. 100 обложек: $5.00.

Вывод: главный рычаг стоимости — разрешение, а не количество сценариев или изображений. Переход с 480p на 1080p почти утраивает цену каждой секунды, а сценарии и картинки на фоне видео почти бесплатны. Планируйте бюджет как сумму секунд по каждому разрешению и закладывайте небольшой запас на повторный рендер отбракованных кадров.

Пропускная способность задаётся лимитом на ключ. Новые ключи по умолчанию получают 10 запросов в секунду, для каждого ключа можно выставить от 1 до 100. Считаются все вызовы, а не только создание задач: опрос статуса, правки раскадровки и запросы на загрузку расходуют тот же лимит. Для выдачи подписанных ссылок на загрузку есть отдельный фиксированный предел — 30 запросов в минуту на ключ, поэтому загружайте референсы до старта большого пакета, а не внутри основного цикла.

При превышении лимита API возвращает HTTP 429 с кодом RateLimitExceeded и стандартными заголовками RateLimit. Прочитайте заголовки, ненадолго отступите и повторите запрос. Очередь, которая держит вашу скорость отправки чуть ниже лимита ключа, почти полностью избавляет от 429, а отдельные ключи под разные нагрузки, например массовый рендер и живой продукт, не дают пакету вытеснить интерактивных пользователей.

Опрос тысячи задач каждые несколько секунд тратит лимит на ответы, которые в основном сообщают, что ничего не изменилось. Вместо этого укажите callback_url в каждой задаче, и API отправит POST с итоговым объектом задачи, когда она завершится успехом или ошибкой; это тот же объект, что возвращает GET. Добавьте callback_secret длиной от 8 до 256 символов, и каждая доставка будет подписана HMAC-SHA256, которую вы проверяете сравнением за постоянное время.

Проектируйте приёмник под правила доставки. Доставка выполняется как минимум один раз (at-least-once), поэтому дедуплицируйте по id задачи. Доставка считается успешной при любом ответе 2xx в течение 5 секунд, редиректы не выполняются, неудачные попытки повторяются до 5 раз — так что отвечайте сразу, а видео скачивайте в фоновой задаче. URL должен быть HTTPS и не может указывать на частные адреса или localhost. Оставьте редкий резервный опрос для задач, которые так и не отчитались.

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

Ещё три привычки сокращают потери. Проверяйте идеи сценарием за $0.01: он возвращает раскадровку без рендера. Используйте режим edit как этап согласования для длинных видео: черновик ждёт с превью-изображениями, а отмена до рендера сразу возвращает полную сумму. И делайте прототипы в 480p: разрешение задаётся моделью, выбранной при создании задачи, поэтому после утверждения раскадровки отправьте её собственными сегментами (segments) в новой задаче на seahorse-720p или seahorse-1080p. Сами инструменты раскадровки разобраны в нашем гайде о покадровом управлении.

Каждый ответ по видеозадаче содержит объект step со стабильным машинным кодом: queued, generating_script, generating_visuals, pending_rendering, rendering, stitching, done, failed или cancelled и другие. Во время рендера он также считает готовые клипы, например {"code": "rendering", "done": 3, "total": 5}. Сопоставьте коды с подписями на своём дашборде и учитывайте, что step может отставать от реальной фазы примерно на 30 секунд.

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