Wan 2.2 API: планирование видеопроцесса с помощью OdiRouter

Редакция OdiRouter

Командам, которым нужен Wan 2.2 API, необходим путь от выбора модели к надежному рабочему процессу создания видео. Начните с каталога видеомоделей OdiRoutercategory=Video), а не скопированный идентификатор или устаревшая таблица цен. Модели, поддерживаемые операции и сведения о тарификации могут меняться. Список в вашем рабочем пространстве является источником достоверной информации о том, доступна ли подходящая модель.

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

Проверьте модель перед созданием запроса

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

Если вы оцениваете Wan 2.2, позвольте результату поиска в каталоге определить следующий шаг. Подходящая запись содержит информацию, необходимую для продолжения. Если подходящей записи нет или она не может выполнить требуемую операцию, выберите из списка видеомодель, соответствующую рабочему процессу. Не предполагайте совместимость.

Настройте API на сервере

OdiRouter OpenAI SDK integration guide показывает, как настроить существующий проект SDK для работы с OdiRouter. Сохраните ключ API в переменной среды на стороне сервера. Он не должен быть частью кода браузера или клиентского приложения.

Этот короткий шаблон настройки запрашивает список моделей. Процесс намеренно останавливается перед вызовом генерации, поскольку правильная форма запроса зависит от модели, выбранной в каталоге.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ODIROUTER_API_KEY,
  baseURL: "https://api.odirouter.ai/v1",
});

const models = await client.models.list();
const selected = models.data.find((model) => model.id.includes("wan"));

if (!selected) {
  throw new Error("Choose a currently listed video model before continuing.");
}

Используйте возвращенный идентификатор и его документированные параметры для следующего запроса. Документация OdiRouter направляет разработчиков к списку моделей, если модель не удается найти. Проверить этот список безопаснее, чем угадывать название по старому руководству.

Относитесь к генерации видео как к задаче

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

Ваше приложение может использовать понятные состояния, такие как queued, running, completed и failed. Ведите журнал идентификатора модели, времени запроса, ссылки на входные данные и ссылки на итоговый результат. Не записывайте в журнал ключ API, подписанные URL-адреса или приватные пользовательские медиафайлы. Небольшой слой статусов поддерживает повторные попытки и устранение неполадок, не предполагая, что у каждой видеомодели одинаковые конечная точка или формат ответа.

Начните с небольшого полезного теста

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

  • недопустимый идентификатор модели;

  • Входные данные, не соответствующие требованиям выбранной модели;

  • Запрос, который не удался или истек срок его действия; и

  • Завершённый результат, который необходимо сохранить или передать пользователю.

На данном этапе ознакомьтесь с действующими условиями использования и ценами в документе OdiRouter. pricing page и каталог моделей должны определять решение по реализации, а не цифры из более старой статьи.

Локализуйте изменения моделей

Разделяйте бизнес-процессы и адаптер, специфичный для конкретной модели. Приложение может создавать задачу генерации видео, отслеживать её статус и доставлять результат через стабильные внутренние интерфейсы. Адаптер содержит идентификатор модели OdiRouter и сопоставление запросов. Когда изменение в каталоге требует работы, обновите и протестируйте адаптер, не переписывая остальную часть продукта.

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

Контрольный список реализации

  1. Просмотрите видеомодели OdiRouter и проверьте доступность.

  2. Ознакомьтесь с актуальной документацией выбранной модели, её параметрами и информацией о ценах.

  3. Создайте и защитите ключ API на стороне сервера.

  4. Настройте задокументированный API-хост и выведите список моделей, прежде чем выбирать идентификатор.

  5. Создайте запрос для конкретной модели на основе актуальной документации.

  6. Отслеживайте асинхронный статус, не раскрывая секреты или приватные медиафайлы.

  7. Протестируйте небольшой рабочий процесс, включая обработку сбоев, до развертывания в производственной среде.

Источники

#API для генерации видео#OdiRouter#Wan 2.2 API