Маршруты Vidu API в OdiRouter охватывают генерацию видео из текста, генерацию видео из изображения, начальный и конечный кадры, а также генерацию на основе референсов. Полезный вопрос не в том, какое название звучит лучше. Он в том, какой маршрут соответствует задаче, которую вам нужно выполнить. Это руководство описывает текущие варианты и показывает процесс работы с очередью, которым должно управлять ваше приложение.
Текущие маршруты Vidu в OdiRouter
В каталоге Video сервиса OdiRouter сейчас перечислены Vidu Q3 Pro, Vidu Q3 Turbo и маршрут Vidu Q3 Reference. Доступность моделей, цены и принимаемые параметры могут меняться. Проверьте актуальный каталог моделей Video, прежде чем фиксировать конфигурацию для продакшена.
Vidu Q3 Pro
viduq3-pro-text2video — ориентированный на качество текстовый маршрут в текущем каталоге. Указанный диапазон составляет от 1 до 16 секунд, с выходными форматами 540p, 720p и 1080p. Доступные соотношения сторон: 16:9, 9:16, 3:4, 4:3 и 1:1. Это же семейство включает подтипы генерации видео из изображения и генерации видео по начальному и конечному кадрам.
Q3 Pro подходит, когда аудиовизуальное качество и синхронизированный звук важнее, чем получение самого быстрого чернового варианта. Оставляйте в рабочем процессе время для проверки рендеринга, а не рассматривайте первый результат как окончательный.
Vidu Q3 Turbo
viduq3-turbo-text2video создан для более быстрой генерации видео из текста. В нем указан тот же диапазон номеров 1 — 16, три разрешения и пять соотношений сторон, что и в текстовом маршруте Pro. Варианты преобразования изображения в видео и начального-конечного кадра в видео также входят в это семейство.
Turbo идеально подходит для быстрой итерации и работы над раскадровками. Это разумный вариант, если команда предполагает создать несколько черновиков, прежде чем выбрать направление.
Vidu Q3 Reference
viduq3-reference2video использует опорный вход. Согласно текущему каталогу, он принимает до семи референсных изображений, чтобы помочь сохранять единообразие объектов между сценами. Он поддерживает вывод длительностью от 3 до 16 секунд в 720p или 1080p с теми же пятью соотношениями сторон. В каталоге OdiRouter он описан как оптимизированный для анимационного материала и материалов в стиле комиксов.
Выберите этот вариант, если самой сложной частью задачи является сохранение непрерывности. Запрос на основе референсов даёт модели больше материала для работы, чем один только текстовый промпт.
Очередь состоит из трёх этапов
Маршруты видео Vidu в OdiRouter выполняются асинхронно. Ваше приложение отправляет задачу, опрашивает её статус, а затем получает ответ после завершения.
Отправьте запрос на генерацию в очередь выбранной модели.
Сохраните возвращённый идентификатор запроса и используйте его для проверки статуса.
Получайте ответ только после завершения задачи.
Отправка не возвращает готовое видео. Производственному коду необходимы крайний срок для опроса, ограниченное число повторных попыток, явная обработка ошибок и надёжное хранение идентификатора запроса.
Отправьте задание Vidu Q3 Turbo
Текущий маршрут Turbo принимает на вход подсказку, длительность, разрешение, аудиофлаг, начальное значение генератора случайных чисел и соотношение сторон. Это минимальная версия заявки:
curl --location 'https://api.odirouter.ai/model/v1/queue/viduq3-turbo-text2video' \
--header 'Authorization: Bearer $ODIROUTER_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "example_prompt",
"duration": 5,
"resolution": "720p",
"audio": true,
"seed": 0,
"aspect_ratio": "16:9"
}'Вставьте идентификатор возвращенного запроса в URL-адреса состояния и ответа маршрута:
https://api.odirouter.ai/model/v1/queue/viduq3-turbo-text2video/requests/{request_id}/status
https://api.odirouter.ai/model/v1/queue/viduq3-turbo-text2video/requests/{request_id}/responseХраните ключ API в секретном ключе на стороне сервера. Ему не место в коде браузера, системе контроля версий, журналах или метаданных медиафайлов.
Прежде чем это попадёт в продакшен
Убедитесь, что маршрут доступен, и повторно ознакомьтесь с его текущей схемой параметров.
Перед отправкой проверьте длительность, разрешение, соотношение сторон и все обязательные медиаданные.
Задайте для опроса максимальный интервал и окончательный крайний срок.
Храните идентификаторы запросов и очищенные сведения об ошибках, чтобы можно было отследить неудачные задачи.
Проверяйте сгенерированные медиафайлы перед публикацией или последующей передачей.
Читайте current pricing and credits вместо того, чтобы встраивать скопированную цену в код приложения.
Данные каталога сообщают, что принимает маршрут. Они не могут сказать, дадут ли ваш промпт и исходные медиа результат, необходимый вашему продукту. Протестируйте репрезентативные входные данные, прежде чем выбирать маршрут по умолчанию.
Сделайте первый запрос
Используйте OdiRouter getting-started documentation вместе с актуальным каталогом моделей. Когда структура запроса будет готова, создайте аккаунт и отправьте контролируемую тестовую задачу.