Агрегатор нейросетей для видео: выбор и проверка API
Агрегатор нейросетей для видео предоставляет несколько моделей через один API. В Relay можно использовать один ключ для seedance-2.5, kling-v3.0 и veo-3.1, сохраняя общий способ авторизации. Модели различаются результатами и параметрами; выбирать их нужно на своих сценах. Для старта потребуются ключ Relay, доступный баланс и оплаченные пополнения на $10. Приветственный бонус не снимает ограничение на видео.
Как выбрать агрегатор нейросетей для видео?
Проверьте путь целиком: создание запроса, получение результата, срок хранения, ошибки и списание. Одного списка моделей недостаточно, если приложение не умеет показать пользователю готовый клип или восстановить задачу после перезапуска.
У Relay единый маршрут создания: POST /v1/videos. В зависимости от модели результат приходит сразу либо через задачу. Приложению нужны оба обработчика. Это позволяет менять модель без замены авторизации, но не делает все возможности моделей одинаковыми.
| Вопрос перед подключением | Что проверять в Relay |
|---|---|
| Есть ли нужная модель? | Точный ID и протокол в каталоге |
| Как получить видео? | Ответ 200 с base64 или 202 с задачей |
| Где найти готовую задачу? | Статус по сохранённому ID |
| Когда скачать файл? | До expires_at асинхронной задачи |
| За что списываются деньги? | За секунды готового видео по цене модели |
Не считайте длину, звук, входное изображение или формат кадра общими свойствами всего каталога. Подтверждайте нужный режим для конкретной модели до разработки интерфейса.
Как подключиться и сделать первый запрос?
Зарегистрируйтесь, проверьте условия пополнения в кабинете и на странице цен, затем создайте отдельный ключ для видеоприложения. Задайте ему лимиты расходов. Личные ключи тратят общий баланс аккаунта; отдельный ключ не создаёт отдельный кошелёк.
Выберите одну модель из каталога видео. Укажите ключ в RELAY_API_KEY на сервере и отправьте короткую сцену. Пример не запускает весь набор сравнения автоматически: сначала стоит проверить один полный цикл.
: "${RELAY_API_KEY:?Задайте RELAY_API_KEY}"
curl --silent --show-error --fail-with-body \
"https://relay-llm.ru/v1/videos" \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2.5",
"prompt": "Одна белая чашка неподвижно стоит на столе. Камера медленно приближается, мягкий дневной свет, нейтральный фон. Без текста и логотипов.",
"duration_seconds": 8
}' --dump-header video-headers.txt --output video-response.jsonВосемь секунд взяты из примера документации. Для каждой сравниваемой модели отдельно подтвердите допустимые значения: общий параметр не гарантирует одинаковые режимы. После первого успеха повторите тот же бриф с kling-v3.0 и veo-3.1, используя отдельные файлы результатов.
Как обработать готовый ответ и очередь?
При HTTP 200 ответ содержит data[0].b64_json: декодируйте байты и сохраните видео. ID задачи при таком результате нет. Не обращайтесь к маршруту статуса с вымышленным идентификатором.
При HTTP 202 сохраните id. Опрос /v1/videos/JOB_ID возвращает queued, running, completed или failed. Проверяйте с паузой в несколько секунд. Запрос статуса не оплачивается, но действует лимит служебных методов.
После completed скачайте /v1/videos/JOB_ID/content с ключом до expires_at. При failed остановите опрос и сохраните ошибку. Подробный контракт обоих путей описан в Videos API.
В своей базе связывайте ID задачи с пользователем и проектом. Статус задачи доступен ключам одного аккаунта Relay, поэтому права между пользователями вашего приложения нужно проверять самостоятельно. Сохранённый ID позволяет продолжить опрос без повторной генерации.
На каких сценах сравнить модели?
Выберите сюжеты будущей работы. Для товарного ролика это неподвижный предмет с движением камеры, для заставки медленный пейзаж, для инструкции одно действие руками. Это набор испытаний, а не утверждение, что каждая модель выполнит их одинаково.
До запуска запишите обязательные признаки: предмет не меняет форму, число объектов сохраняется, камера движется нужным способом, нет лишнего текста. Посмотрите каждый ролик целиком. Первый красивый кадр не показывает, как объект поведёт себя в конце.
По возможности сначала оценивайте файлы без названий моделей. Записывайте причину отказа словами: «чашка изменила ручку», «камера вращается вместо наезда». Оценка «плохо» не подскажет, какой следующий тест нужен.
Как посчитать стоимость пригодного результата?
Сложите фактические списания всей серии и разделите на число принятых роликов. Если не принят ни один, удельную стоимость посчитать нельзя: нужно изменить бриф, модель или требования. Не делите расход на число созданных файлов, если часть из них непригодна.
Успешно созданный, но отклонённый вами клип учитывается в расходах. За асинхронную задачу со статусом failed списания нет. Актуальную ставку за секунду берите из каталога; здесь нет измерений, позволяющих объявить одну модель самой дешёвой или качественной.
При таймауте после POST сначала проверяйте сохранённую задачу и журнал. Немедленный повтор может создать второй запрос. Остальные ошибки разбирайте по справочнику API, учитывая код и заголовки повтора.
Агрегатор нейросетей для видео сам выбирает лучшую модель?
В описанном сценарии модель выбирает приложение. Вывод о качестве делается по вашим сценам, критериям и расходам.
Нужны ли отдельные ключи для каждой модели?
Для моделей, разрешённых вашему ключу Relay, можно использовать один ключ. У каждой сохраняются своя цена и возможности.
Один API означает одинаковую длительность видео?
Нет. Параметры выбранной модели нужно проверить отдельно. Общий маршрут не доказывает одинаковую поддержку режимов.
Можно ли хранить готовое видео только по ссылке задачи?
Скачайте файл до expires_at и храните в своей системе. Маршрут содержимого не служит бессрочным архивом.