Руководство по API для Wan 2.6 Reference to Video | OdiRouter

API Wan 2.6 Reference to Video позволяет приложению отправлять задачу по созданию видео на основе текстового запроса и URL-адресов референсов. OdiRouter документирует модель как wan2.6-r2v и возвращает URL-адреса очереди для отслеживания отправленного задания. Интеграцию следует строить вокруг четырех основных элементов: удобных ссылок, четкого запроса, корректного запроса в очередь и тщательной обработки возвращаемых URL-адресов задач.

Когда видео с использованием референсов полезно

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

OdiRouter описывает Wan 2.6 Reference to Video как модель, использующую референсные ориентиры для сохранения персонажа и стиля в движении. Используйте эти ориентиры, чтобы определить важный визуальный материал до запроса кадра.

Подготовьте вместе ссылки и подсказки.

Используйте URL-адреса референсов, к которым ваше приложение может получить доступ. Конкретно опишите объект и предполагаемое действие. В примере OdiRouter используются метки типа character1, что может упростить идентификацию указанного субъекта в подсказке.

Перед отправкой запроса примите решение:

• Какой объект или сцена должны оставаться узнаваемыми.

• Что происходит во время съёмки.

• Какие исключения относятся к negative_prompt?

• Соответствует ли запросу документированный single или multi shot_type.

• Настройки вывода, необходимые приложению, включая duration и size.

Один лишь URL-адрес референса не объясняет предполагаемое движение, кадрирование или действие. Укажите эти требования в запросе.

Отправьте задачу Wan 2.6 по преобразованию референса в видео

OdiRouter документирует конечную точку очереди для wan2.6-r2v. В этом запросе используются документированные имена полей и учётные данные-заполнители. Храните настоящий ключ API в хранилище секретов на стороне сервера — никогда не размещайте его в коде браузера или в закоммиченном файле.

curl --location "https://api.odirouter.ai/model/v1/queue/wan2.6-r2v" \
  --header "Authorization: Bearer $ODIROUTER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "character1 walks slowly through a clean studio scene with a consistent appearance.",
    "negative_prompt": "distorted face, extra limbs",
    "reference_urls": [
      "https://example.com/reference.webp"
    ],
    "duration": 2,
    "size": "1280 720",
    "shot_type": "single",
    "watermark": false,
    "seed": 12345
  }'

Пример показывает структуру запроса. Проверьте URL-адрес референса и значения параметров в своей интеграции, затем ознакомьтесь с текущим Wan 2.6 Reference to Video documentation, прежде чем изменять код в рабочей среде.

Рассматривайте ответ как квитанцию о задаче

Первичный ответ очереди содержит request_id, а также URL-адреса для получения результата, статуса и отмены. Сохраните файл request_id вместе с рабочим элементом в вашем приложении. Проверяйте status_url для отслеживания прогресса и используйте response_url для получения завершённого ответа. Используйте cancel_url только для явного действия по отмене в вашем продукте.

Успешная отправка не означает, что видео готово. Сохраняйте статус задания «в ожидании», пока данные статуса и ответа не покажут, что приложение может представить результат. Если задача не завершается должным образом, сохраните идентификатор запроса и любые сведения об ответе API, которые можно безопасно зарегистрировать, а затем следуйте стандартной процедуре повторной попытки или обратитесь в службу поддержки.

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

• Храните ODIROUTER_API_KEY на сервере и передавайте его только в заголовке авторизации.

• Проверяйте URL-адреса референсов до постановки работы в очередь.

• Укажите в запросе объект референса и запрошенное действие.

• Сохраняйте request_id и возвращённые URL-адреса задачи вместе с записью о задании.

• Намеренно опрашивайте статус, а не приравнивайте отправку в очередь к завершению.

• Повторно проверяйте official model reference при изменении полей запроса или логики обработки.

Начните с документированного контракта API

Рабочим процессом легче управлять, когда явно определены и творческий запрос, и жизненный цикл задачи. Используйте OdiRouter Wan 2.6 Reference to Video API documentation в качестве источника истины для контракта модели. Затем выстройте проверку, отслеживание очереди и обработку результатов вокруг URL-адресов, возвращаемых для каждого запроса.