API для ИИ-апскейлинга видео позволяет производственной команде проверить, улучшает ли модель уже имеющиеся у неё видеоклипы. Одних лишь дополнительных пикселей недостаточно. Модель, требования к входным данным, время обработки и стоимость должны соответствовать задаче. OdiRouter предоставляет разработчикам каталог моделей, API-документацию и маршрутизацию моделей. Сначала откройте актуальный OdiRouter Models catalog, затем подтвердите документацию и цену модели, которую планируете использовать.
Начните с нужного результата
Прежде чем выбирать модель, определите, что должно сохраняться в обработанном видео. В демонстрации продукта наибольшее значение могут иметь текст на экране и границы элементов интерфейса. В динамичном спортивном клипе стабильность движения может быть важнее мелких деталей текстуры. Архивный материал может нуждаться в более чистом виде без эффекта, при котором лица или надписи выглядят выдуманными.
Используйте небольшой набор репрезентативных клипов. Включите материалы, которые с высокой вероятностью вызовут проблемы в производстве: движение камеры, сжатое видео, тонкие линии, субтитры, тёмные сцены и переходы. До пилотного запуска задайте разрешение для выдачи и критерий приемки. Иначе качественно подготовленный пример может скрыть плохое соответствие производственным требованиям.
Проверьте актуальную модель перед интеграцией
Доступность моделей, поддерживаемые форматы, параметры и цены меняются. Не следует напрямую указывать название модели из статьи в блоге или предполагать наличие той или иной возможности только потому, что её предлагает аналогичный поставщик. Просмотрите информацию о модели OdiRouter Models catalog в режиме реального времени, воспользуйтесь категорией «Видео» и откройте текущую документацию для модели, которую вы хотите протестировать.
На главной странице OdiRouter представлен каталог из 200+ ИИ-моделей, а также ссылки на разделы «Модели», «Цены» и «Документация». Используйте каталог, чтобы увидеть, что доступно сейчас. Ознакомьтесь с информацией на карточке модели, чтобы узнать о необходимых элементах управления входом и выходом, примечаниях к лицензии и единице измерения цены. Проверьте OdiRouter Pricing, прежде чем формировать бюджет или называть цену клиенту.
Создайте рабочий процесс асинхронных запросов.
Документация по началу работы OdiRouter охватывает API-ключи, авторизацию, идентификаторы моделей и примеры первых запросов. Её примеры API моделей используют жизненный цикл запроса с идентификатором запроса и URL-адресами для ответа, статуса и отмены. Стройте процесс вокруг этого жизненного цикла, а не оставляйте браузерный запрос открытым на всё время выполнения задачи.
Создайте учётную запись и получите API-ключ.
Выберите актуальный идентификатор модели из каталога и ознакомьтесь с её справочником API.
Загрузите или предоставьте входные данные в формате, который поддерживает выбранная модель.
Отправьте запрос, затем сохраните возвращённый
request_idи адрес статуса.Опрашивайте статус с контролируемым интервалом, прекращайте опрос при достижении конечного состояния и сохраняйте URL результата в записи задания.
Регистрируйте сбои отдельно от успешных рендеров, чтобы логика повторных попыток не скрывала проблему с моделью или входными данными.
Для точного адреса конечной точки и JSON-полей используйте справочник, специфичный для модели. В публичной документации показаны авторизация с помощью API-ключа Bearer и запросы к моделям в стиле очереди. Не храните ключи в системе контроля версий и клиентском коде.
curl --location "https://api.odirouter.ai/model/v1/queue/<current-model-id>" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{"input":"use the parameters defined by the selected model"}'Пример демонстрирует структуру серверного запроса, а не универсальный список параметров. Заменяйте заполнитель только после проверки актуального справочника выбранной модели.
Проверьте обработку входных данных и качество результата
В документации к файлу OdiRouter перечислены поддерживаемые MIME-типы видеофайлов для данного файлового процесса. Выбранная модель может иметь более узкие ограничения. Проверьте продолжительность, размер, соотношение сторон, а также любые требования к загрузке или URL-адресу на странице этой модели.
Оцените результаты при обычной скорости воспроизведения и покадрово. Обращайте внимание на нестабильные детали, искажённый текст, ореолы по краям, временное мерцание и изменения лиц, логотипов или подписей. Для каждого теста храните вместе оригинал, настройки запроса и результат. Это упрощает сравнение с другой моделью или воспроизведение результата после обновления каталога.
Включите контроль затрат в пилотный проект
При обработке видео небольшая разница в стоимости одной задачи может многократно увеличиться на большом пакете. Начните с ограниченного пилотного проекта: ограниченный набор клипов, максимальная продолжительность, определенный целевой показатель результата и ответственный за утверждение. Записывайте входные параметры, влияющие на стоимость для выбранной модели, затем сопоставляйте каждый завершённый результат с критерием приемки.
Перед запуском в производство ещё раз проверьте актуальные цены. Текущая единица тарификации модели и доступные параметры должны быть указаны в конфигурации интеграции и примечаниях к релизу, а не считаться неизменными по умолчанию. Страница OdiRouter Pricing предназначена для проверки актуального значения.
Практический контрольный список для запуска
Подтвердите актуальный идентификатор модели и справочник API, специфичный для модели, в OdiRouter.
Протестируйте репрезентативные исходные клипы, включая сцены из реальной нагрузки, склонные к сбоям.
Для каждого задания сохраняйте идентификаторы запросов, настройки модели, изменения статуса и расположения результатов.
Применяйте политику повторных попыток только к документированным временным сбоям.
Перед расширением пакета оцените качество и стоимость по тем же критериям приемки.
Повторно проверяйте доступность модели и цены при изменении рабочего процесса.
Изучите OdiRouter Models catalog, прочитайте Getting Started documentation и протестируйте актуальный вариант для видео на контролируемом наборе клипов.