При изучении Wan 2.7 API начинайте с рабочего процесса, который необходимо поддерживать, а не только с названия конечной точки. Надёжной интеграции для работы с видео необходимы проверка актуальной доступности, контракт запроса, способ отслеживания асинхронной обработки и план тестирования возвращаемых файлов. OdiRouter предоставляет возможность проверить текущие параметры видеокарты и следовать официальным инструкциям по настройке.
В этом руководстве не утверждается, что Wan 2.7 в настоящее время доступен через OdiRouter. Каталоги моделей меняются. Проверьте каталог Video OdiRouter, прежде чем привязывать архитектуру приложения к конкретной модели или маршруту.
Начните с задачи, которую должен выполнять ваш продукт
Видео-API часто охватывают связанные рабочие процессы. Выберите тот, который соответствует входным данным, которые ваш продукт может надёжно предоставить:
Преобразование текста в видео подходит для процесса создания, основанного только на текстовом запросе.
Преобразование изображения в видео подходит, когда у вас есть начальный кадр или утверждённый визуальный ресурс.
Генерация на основе референсов подходит для случаев, когда объект, стиль или предоставленный материал должны влиять на результат.
Редактирование или расширение видео начинается с существующего клипа.
Рабочий процесс определяет поля, которые вы проверяете, ресурсы, которые храните, запрашиваемую длительность и проверки, которые выполняете для результата. Не считайте конечные точки с похожими названиями взаимозаменяемыми. Откройте запись каталога для модели, которую планируете использовать, и изучите задокументированные поля ввода, тип вывода и поведение задачи.
Перед интеграцией проверьте актуальный каталог
Используйте видеокаталог OdiRoutercategory=Video) в качестве текущего источника для списков моделей и сведений о конечных точках. Подтвердите следующие пункты для выбранной вами конкретной записи:
Модель указана в списке, и конечная точка соответствует необходимому вам рабочему процессу.
Способы ввода и обязательные поля соответствуют ресурсам, которые может собирать ваше приложение.
Параметры формата вывода и продолжительности работы применяются к используемому вами конвейеру доставки.
Жизненный цикл задачи объясняет, как получать статус запроса и окончательный ответ.
Путь для учётной записи, аутентификации и настройки соответствует official getting-started documentation.
Доступность, параметры и цены меняются. Не включайте их в жёстко заданный текст интерфейса, пока ваш процесс выпуска не проверит актуальный каталог повторно.
Рассматривайте рабочий процесс Wan 2.7 API как задачу в очереди
Генерация видео занимает больше времени, чем типичный синхронный запрос. Рассматривайте её как задачу в очереди с надёжно сохранённой записью запроса. Отправьте запрос, сохраните его идентификатор вместе с нормализованными входными данными, запрашивайте статус по ограниченному расписанию, получите завершённый результат и остановитесь при терминальном состоянии ошибки или отмены.
Сохраняйте исходный промпт, выбранный эндпоинт, соответствующие URL-адреса ресурсов, запрошенную длительность, соотношение сторон, разрешение и seed, если провайдер его поддерживает. Эти значения позволяют воспроизвести проблему или объяснить иной результат. Не записывайте в журналы токен авторизации и не храните ненадёжный исходный ресурс дольше, чем допускает утверждённая вашей командой политика.
Используйте актуальную запись каталога OdiRouter в качестве источника для реализации
Эта структура запроса использует актуальный пример из видеокаталога OdiRouter. Это не означает, что данный маршрут является эндпоинтом Wan 2.7. Заменяйте маршрут и поля только после проверки записи в каталоге, на которую вы собираетесь позвонить.
curl --location 'https://api.odirouter.ai/model/v1/queue/pixverse-v6-t2v' \
--header 'Authorization: Bearer $ODIROUTER_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "A short product scene with stable camera movement",
"duration": 5,
"quality": "720p",
"generate_audio_switch": false
}'Пример из каталога также показывает маршруты для запроса статуса, получения ответа и отмены запроса. Разместите эти операции на уровне сервиса, а не оставляйте браузерную сессию ждать длительно выполняющуюся задачу.
Добавьте проверки для продакшена перед запуском
Ответ от 200 — это ещё не конец работы. Протестируйте весь рабочий процесс, используя показательные подсказки и ресурсы.
Проверить | Почему это важно |
|---|---|
Проверка входных данных | Отклонять отсутствующие запросы, неподдерживаемые ресурсы и недопустимые значения длительности или качества до того, как задание попадет в очередь. |
Идемпотентность | Предотвращайте создание непреднамеренной второй задачи при повторной попытке после сетевого тайм-аута. |
Ограниченный опрос | Увеличивайте интервалы между проверками статуса и прекращайте опрос, когда задача достигает терминального состояния. |
Проверка результата | Убедитесь, что возвращённый артефакт существует, доступен для скачивания и совместим с вашим последующим проигрывателем или хранилищем. |
Наблюдаемость | Записывайте идентификаторы запросов, переходы состояний, задержку и безопасные категории ошибок, чтобы сбои можно было устранять. |
Проверка прав | Убедитесь, что использование вами промптов, исходных ресурсов, результатов и условий, специфичных для модели, соответствует требованиям вашего продукта и законодательства. |
Сохраняйте возможность замены модели
Полезный вывод из исследования Wan 2.7 API заключается в том, чтобы отделить рабочий процесс продукта от названия какой-либо одной модели. Разместите выбор эндпоинта и сопоставление параметров за небольшим адаптером, сохраняйте версионированные данные запросов и предоставьте операторам возможность сравнивать завершённые задачи. Это упрощает переход к другой актуальной записи каталога при изменении доступности или требований.
Следующий шаг
Откройте видеокаталог OdiRouter, выберите актуальную модель, соответствующую вашему рабочему процессу, и используйте getting-started documentation для завершения настройки.