API для преобразования ссылки в видеофайл Vidu: создайте его с помощью OdiRouter

API преобразования референса в видео Vidu превращает именованные визуальные референсы и текстовую инструкцию в поставленную в очередь задачу создания видео. В OdiRouter текущий эндпоинт указан как viduq2-reference2video. Надёжная интеграция отправляет корректные входные данные, сохраняет URL-адреса задачи и ожидает завершения, прежде чем считывать результат.

Сначала ознакомьтесь со справочником модели

OdiRouter документирует Vidu Q2 Reference to Video как эндпоинт мультимодальных задач. Начните с Vidu Q2 Reference-to-Video reference, поскольку доступные параметры относятся к модели, а не к универсальному запросу на создание видео.

В OdiRouter в качестве базового URL для мультимодальных запросов указан https://api.odirouter.ai/model. Создайте задачу с помощью POST /v1/queue/{endpoint} и аутентификации Bearer. Храните API-ключ в серверном коде. В multimodal setup guide описан общий шаблон запроса.

Дайте каждому референсу понятное имя

Эндпоинт требует subjects. У объекта есть name и массив images. Затем в промпте на него можно ссылаться с помощью @name. Текущая эталонная модель позволяет использовать от одного до семи объектов, от одного до семи изображений в общей сложности и до трех изображений на каждый объект. Дайте каждой визуальной идентичности постоянное имя, а затем опишите действие, используя эти имена.

{
  "prompt": "@speaker walks through a quiet studio while the camera moves from a wide shot to a closer view.",
  "subjects": [
    {
      "name": "speaker",
      "images": ["https://example.com/reference-speaker.jpg"]
    }
  ],
  "audio": false,
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

В этом примере показана структура запроса, а не гарантированный результат. Используйте доступные URL-адреса изображений или данные изображений в формате Base64. В справочнике модели перечислены форматы PNG, JPEG/JPG и WebP. Также требуется референсное изображение размером не менее 128x128, размер каждого файла ограничен 50MB, а тело HTTP POST-запроса — 20MB. Проверьте эти ограничения перед отправкой задачи.

Выбирайте элементы управления целенаправленно.

• prompt является обязательным и может содержать до 5,000 символов.

• duration принимает значения от 1 до 10 секунд; значение по умолчанию — 5.

• resolution поддерживает 540p, 720p и 1080p; документированное значение по умолчанию — 720p.

• Эта конечная точка также документирует audio, audio_type, seed, aspect_ratio, элементы управления водяными знаками и callback_url.

Сохраняйте отправляемый запрос, но не включайте учетные данные в эту запись. Если вам нужны воспроизводимые эксперименты, установите seed. Если вы используете обратный вызов, перед его отправкой проверьте этот URL в собственном сервисе. Для получения значений полей и актуальных ограничений используйте model reference, а не старую заметку о выпуске.

Рассматривайте создание задачи и ее завершение как отдельные состояния.

Ответ на создание включает request_id, status_url, response_url и cancel_url. Сохраните эти значения вместе с собственной записью о задаче. Ваше приложение может использовать их, чтобы отображать ход выполнения, продолжать опрос после перезапуска и отменять работу, которая пользователю больше не нужна.

Отправленный запрос — это еще не готовое видео. OdiRouter result guide сообщает, что конечная точка результата может возвращать HTTP 202, пока обработка всё ещё выполняется. Опрашивайте URL статуса или ответа с ограниченным числом повторных попыток и стратегией увеличения интервалов, подходящей для вашего сервиса. После завершения задачи прочитайте содержимое выходных данных из ответа, вместо того чтобы самостоятельно создавать URL-адрес медиафайла.

Считайте ссылки на результаты временным выводом.

В документации к результату OdiRouter указано, что сгенерированные медиа-ссылки в настоящее время по умолчанию доступны в течение семи дней. Возвращаемый URL имеет ограниченный срок хранения. Не передавайте эту информацию лицам, которым вы не доверяете. Если вам требуется более долговременное хранение или средства управления доступом для обмена, управляйте результатом в системах, контролируемых вашей командой, и соблюдайте собственную политику хранения.

Краткий контрольный список для потока запросов

1. Проверяйте количество изображений, формат, размеры и размер тела запроса до создания задачи.

2. Дайте каждому объекту уникальное имя и используйте это имя в подсказке вместе с @.

3. При успешном создании сохраните URL-адреса задачи и идентификатор корреляции вашего приложения.

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

5. После завершения получите результат, затем примените собственные правила хранения и доступа к возвращенной ссылке.

Держите выбор, зависящий от конкретной модели, рядом с документацией конечной точки. Пусть ваше приложение отвечает за проверку, повторные попытки и контроль доступа. Начинайте реализацию с актуального OdiRouter Vidu Q2 Reference-to-Video API documentation.