Vidu Q3 API преобразования референса в видео с OdiRouter

API Vidu Q3 для преобразования референса в видео принимает референсные изображения и текстовый промпт, а затем создаёт задание на видео в очереди через OdiRouter. OdiRouter описывает endpoint модели, жизненный цикл задания и настройки, важные для продукта, которому требуется создание видео на основе референсов.

Что принимает конечная точка OdiRouter

OdiRouter описывает Vidu Q3 Reference-to-Video как endpoint модели. Создайте задачу с помощью POST /v1/queue/viduq3-reference2video. Базовый URL API модели: https://api.odirouter.ai/model.

Запрос может содержать от 1 до 7 референсных изображений. Документация допускает использование публичных URL-адресов изображений или данных Base64. Среди поддерживаемых форматов указаны PNG и JPEG, а также JPG и WebP.

Отправьте вместе с запросом промпт и длительность. Документированный диапазон длительности составляет от трёх до шестнадцати секунд. По умолчанию — пять секунд. OdiRouter описывает распространённые варианты соотношения сторон вывода, включая auto. В документе также описаны варианты разрешения вывода до 1080p. Также описана опция синхронизированного аудио-видео и начальное значение для повторяющихся запусков.

Для референсов на основе URL используйте общедоступные изображения, соответствующие документированным ограничениям. Размер изображения должен составлять не менее 128 на 128 пикселей. Документированное нижнее значение соотношения сторон — 1:4. Верхнее значение соотношения сторон — 4:1. Размер каждого изображения не должен превышать 50 MB.

Создайте задание на видео

Начните с endpoint очереди и ключа API OdiRouter. Этот запрос демонстрирует базовую структуру. Замените URL изображения и промпт материалами, которые ваше приложение имеет право использовать.

curl --request POST \
  'https://api.odirouter.ai/model/v1/queue/viduq3-reference2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "images": ["https://example.com/reference-image.jpg"],
    "prompt": "A short product scene with a clear subject and natural motion.",
    "resolution": "720p",
    "duration": 5
  }'

В ответе вы получите request_id и URL-адреса для проверки статуса, получения ответа и отмены. Сохраните ID, чтобы приложение могло отслеживать задание, а не считать первый ответ готовым видео.

Проверьте статус и получите ответ

OdiRouter описывает отдельные endpoint для каждого действия с очередью:

Проверьте URL статуса, используя возвращённый ID запроса. Запросите результат только после того, как задача достигнет соответствующего состояния завершения. Сохраняйте возможность отмены для задач, выполнение которых больше не требуется.

Спланируйте набор эталонных данных

Прежде чем масштабировать рабочий процесс, определите, какие ссылки необходимо установить. Они могут задавать объект, вид продукта, визуальный стиль или несколько таких параметров. Выбирайте соотношение сторон и разрешение для канала, где будет использоваться видео, вместо применения одних и тех же настроек повсюду.

Во время тестирования храните вместе промпт, небольшой набор референсов и возвращённый ID запроса. Когда необходимо сравнить настройки, используйте seed согласно документации, чтобы запуск было проще повторить. Эти практики помогают организовать интеграцию. Они не гарантируют конкретный результат генерации.

Продолжите с OdiRouter

Ознакомьтесь с Vidu Q3 Reference-to-Video API documentation, чтобы узнать актуальные поля и сведения об ответе. Посетите OdiRouter model catalog, чтобы ознакомиться с доступными моделями, или начните с OdiRouter getting started guide перед подключением приложения.

Источники

• OdiRouter Vidu Q3 Reference-to-Video API documentation

• OdiRouter model catalog