Руководство по API Vidu для создания видео по начальному и конечному кадрам | OdiRouter

API Vidu для создания видео по начальному и конечному кадрам работает на основе двух визуальных опор: первого и последнего изображения. OdiRouter описывает маршрут viduq2-pro-start-end2video для создания асинхронной задачи на основе этих изображений и текстового запроса. Он подходит для процессов, в которых важны и начальная сцена, и предполагаемый конечный результат.

Это руководство по реализации OdiRouter. Оно не гарантирует визуальный результат. Перед использованием в рабочей среде ознакомьтесь с документацией модели, чтобы уточнить текущую доступность, цены и поддерживаемые параметры.

Что делает задача создания видео по двум кадрам

Vidu Q2 Pro Start End to Video принимает два изображения. Первое загруженное изображение является начальным кадром, а второе — конечным. Маршрут OdiRouter также принимает текстовый запрос и параметры длительности, разрешения и амплитуды движения. В его ответе предоставляются URL-адреса задач для проверки статуса и получения результата.

Вы задаёте модели начало и конец, вместо того чтобы просить процесс преобразования текста в видео вывести всю последовательность из текста. Текстовый запрос описывает движение или преобразование между этими кадрами.

Подготовьте два входных изображения

Сначала отправьте вступительное изображение, а затем заключительное. В документации к OdiRouter описаны следующие правила ввода:

• Разрешения изображений должны быть близкими. Задокументированное соотношение разрешений от начального до конечного кадра — от 0.8 до 1.25.

• Соотношение сторон каждого изображения должно находиться в диапазоне от 1:4 до 4:1.

• Укажите общедоступный URL-адрес изображения или данные изображения в формате Base64.

• Поддерживаются форматы PNG, JPEG, JPG и WebP. Размер изображения не должен превышать 50 MB, а размер тела HTTP-запроса POST — 20 MB.

Композиция имеет значение. Когда положение объекта существенно меняется между кадрами, опишите в промпте ожидаемое движение и проверьте репрезентативные результаты, прежде чем автоматизировать задачу.

Создайте задачу OdiRouter

OdiRouter документирует POST /v1/queue/viduq2-pro-start-end2video по базовому URL своей модели. Для каждого запроса требуется API-ключ OdiRouter. Не размещайте настоящие ключи в клиентском коде и публичных примерах.

curl --request POST "https://api.odirouter.ai/model/v1/queue/viduq2-pro-start-end2video" \
  --header "Authorization: Bearer $ODIROUTER_API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "images": [
      "https://example.com/start-frame.png",
      "https://example.com/end-frame.png"
    ],
    "prompt": "A steady camera move from the opening scene to the final scene",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "movement_amplitude": "medium"
  }'

Указанные выше URL-адреса и промпт являются заполнителями. Заменяйте их только значениями, которые ваше приложение авторизовано отправлять. В текущей документации по маршруту указаны значения продолжительности от 1 до 8 секунд.

Документированные значения разрешения:

• 540p

• 720p

• 1080p

Задокументированные значения амплитуды движения следующие:

• auto

• small

• medium

• large

Отслеживание асинхронного результата

Ответ на создание включает request_id, а также URL-адреса для проверки статуса, получения ответа и отмены. Документ OdiRouter описывает следующие конечные точки:

• GET /v1/queue/viduq2-pro-start-end2video/requests/{request_id}/status проверяет состояние задачи.

• GET /v1/queue/viduq2-pro-start-end2video/requests/{request_id}/response получает завершенный результат.

• PUT /v1/queue/viduq2-pro-start-end2video/requests/{request_id}/cancel отменяет задачу.

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

Используйте элементы управления с планом проверки

Начните с movement_amplitude: "auto", чтобы установить базовый уровень. Перейдите к small, medium или large после проверки результатов, похожих на ваш исходный материал. Укажите в промпте желаемый переход, поведение камеры и видимый объект. Это делает критерии проверки более ясными, чем общий запрос на определённый стиль.

В маршруте также документированы seed, bgm, элементы управления водяными знаками, payload, meta_data и callback_url. Подтвердите текущее поведение необязательных полей в Vidu Q2 Pro Start End to Video documentation.

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

Ознакомьтесь с Vidu Q2 Pro Start End to Video documentation, чтобы получить полную схему запроса и ответа. Для получения сведений об API-ключах и более широком рабочем процессе модели начните с OdiRouter introduction. model catalog и current pricing полезны при планировании интеграции.

Источники

• OdiRouter: Vidu Q2 Pro Start End to Video

• OdiRouter documentation introduction