API для генерации NSFW-видео: быстрый старт с Nureta Developer API

Nureta Developer API — это движок потребительского приложения Nureta, открытый по HTTPS для разработчиков, студий и приложений. Один API-ключ покрывает генерацию видео, изображений и сценариев с единым жизненным циклом задачи: создание, опрос, финальный статус. Видеомодели — seahorse-480p, seahorse-720p и seahorse-1080p. Можно рендерить одиночные клипы по 5, 8, 10, 12 или 15 секунд либо склеенные многокадровые сцены от 16 до 180 секунд; звук генерируется по умолчанию.

Для более тонкого контроля можно приложить до 9 референсных изображений, закрепить first_frame или last_frame либо передать собственную раскадровку segments[], где у каждого плана свой сценарий, длительность 4–15 секунд и флаг explicit: подводящие планы остаются неоткровенными, а кульминационные — откровенными. Режим edit готовит черновик раскадровки и останавливает его в статусе planned с превью-картинками, чтобы до оплаты рендера можно было поменять биты.

Настройка занимает три шага. Первый — войдите на developer.nureta.ai через Google. Второй — создайте API-ключ в аккаунте (инструкция: https://developer.nureta.ai/docs); новые ключи допускают 10 запросов в секунду, лимит настраивается от 1 до 100. Третий — пополните предоплаченный баланс в USDC в сети Base на странице Billing, где 1 USDC равен $1.00, а карта не нужна. Отдельно ждать выдачи доступа не придётся.

Обращайтесь с ключом как с любым другим секретом. Храните его в переменной окружения на своём сервере, никогда не встраивайте в браузерный или мобильный код и перевыпустите, если он утёк. Каждый вызов аутентифицируется ключом как bearer-токеном: Authorization: Bearer sk-.... Если баланса не хватает на новую задачу, API возвращает AccountOverdueError, а не выставляет счёт позже.

Минимальный 5-секундный запрос text-to-video — это один вызов curl: curl -X POST https://developer.nureta.ai/api/v3/contents/generations/tasks -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" -d '{"model":"seahorse-480p","content":[{"type":"text","text":"two adults share a slow dance in a candlelit loft"}],"duration":5}'. В ответ приходит id задачи вида {"id":"cgt-..."}.

Дальше добавляйте поля по мере необходимости. Задайте duration до 180 для склеенной сцены, добавьте "ratio":"9:16" для вертикального видео (также доступны 16:9, 4:3, 3:4, 1:1, 21:9 и adaptive), приложите элементы image_url как референсные изображения или передайте callback_url, чтобы получить вебхук. Пишите промпт как короткую сцену по порядку: кто вымышленные взрослые персонажи, где они находятся и что происходит. Связный текст работает лучше, чем набор ключевых слов.

Видео генерируется минутами, поэтому API асинхронный. Опрашивайте GET /api/v3/contents/generations/tasks/{id} с тем же bearer-ключом, пока status не станет succeeded или failed; у успешной задачи есть content.video_url. Пока задача идёт, объект step сообщает этап, например {"code":"rendering","done":3,"total":5}, — этого хватает для индикатора прогресса. Скачайте файл и сохраните его у себя без промедления.

Опрос не обязателен. Передайте callback_url при создании задачи, и Nureta отправит готовый объект задачи на ваш HTTPS-эндпоинт, когда она завершится успехом или ошибкой. Добавьте callback_secret — и каждая доставка будет подписана HMAC-SHA256; проверяйте подпись, прежде чем доверять данным. Доставка «как минимум один раз», поэтому дедуплицируйте по id задачи. Стоимость неудачной генерации автоматически возвращается на баланс.

Оплата — за секунду видео, списывается с предоплаченного баланса. Таблица цен: seahorse-480p — $0.1888 в секунду ($0.944 за 5 секунд); seahorse-720p — $0.2773 в секунду ($1.3864 за 5 секунд); seahorse-1080p — $0.5428 в секунду ($2.7139 за 5 секунд). Сцена на 60 секунд в 480p обойдётся примерно в $11.33. Публичный эндпоинт GET /api/v3/models возвращает актуальные цены, поэтому читайте их оттуда, а не прописывайте в коде.

Сумма резервируется при создании задачи и возвращается, если задача не удалась, так что сломанный рендер ничего не стоит. Это отдельно от потребительского приложения Nureta, где 5-секундное видео стоит $1.29 с оплатой в USDC, а первое 5-секундное видео бесплатно при входе через Google. Не смешивайте их в сметах для клиента: посекундная цена — для кода, цена за видео — для людей, которые пользуются nureta.ai.

Использование API регулируется контент-политикой Nureta: только взрослые, никаких несовершеннолетних, включая вымышленных, никаких реальных людей без их согласия, публичных лиц и контента без согласия. Референсные изображения, похожие на публичное лицо, отклоняются автоматически. Фото лица можно использовать только с согласия изображённого взрослого на контент 18+, а функций замены лица и «раздевания» в API нет. О нарушениях сообщается в NCMEC, где это требуется.

Если вы строите продукт для своих пользователей, политика распространяется и на них. Пускайте пользователей только после проверки 18+, собирайте согласие на любое загружаемое ими фото и оставляйте сцены вымышленными. SDK предоставляются по запросу; все примеры работают с обычным curl. Поэтому интегрироваться можно на любом языке, который умеет отправлять HTTPS-запросы.