Для интеграции Alibaba Wan 2.5 API преобразования текста в видео начните с актуального каталога OdiRouter. Не предполагайте, что старый идентификатор модели или тело запроса по-прежнему будут работать. В общедоступной документации OdiRouter в настоящее время в каталоге генерации видео указано «Wan 2.5 Preview Text to Video», а API моделей позволяют проверить, что доступно для вашего API-ключа, прежде чем полагаться на это.
Интеграциям для работы с видео полезна такая дополнительная проверка. Доступность моделей, названия endpoint и принимаемые поля могут меняться. Предварительный поиск модели — простой способ поддерживать соответствие приложения текущему каталогу OdiRouter, а не скопированному примеру.
Сначала проверьте каталог видеомоделей
OdiRouter документирует каталог моделей endpoint по адресу https://api.odirouter.ai/v1/models/catalog. Каталог поддерживает фильтры по ключевому слову, категории, поставщику, входной модальности и выходной модальности. Для преобразования текста в видео используйте полученный ответ, чтобы найти подходящий вариант видео и просмотреть его идентификатор, поставщика, режимы воспроизведения и другие возвращенные метаданные.
curl --location \
"https://api.odirouter.ai/v1/models/catalog?keyword=wan&category=video&input_modality=text&output_modality=video&page=1&page_size=20" \
--header "Authorization: Bearer ${ODIROUTER_API_KEY}"Используйте результат каталога как основу для принятия решения. Убедитесь, что эта опция активна для вашей учетной записи и что ее параметры соответствуют рабочему процессу, который вы хотите создать. Если вам требуется конкретная настройка, перед отправкой рабочего запроса проверьте актуальные сведения о модели и документацию.
Отправьте задачу через задокументированный асинхронный процесс
OdiRouter документирует мультимодальную генерацию как асинхронный процесс обработки задач. В руководстве по отправке задач URL запроса формируется из https://api.odirouter.ai/model и текущей модели endpoint. Тело запроса зависит от выбранного вами endpoint, поэтому отправляйте только поля, поддерживаемые текущей документацией.
curl -sS -X POST "https://api.odirouter.ai/model/v1/queue/${ENDPOINT}" \
--header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A short scene described for the selected video model."
}'Документированный ответ включает request_id, а также поля status_url, response_url и cancel_url. Сохраните идентификатор запроса вместе с собственной записью о задаче. Это дескриптор для проверки статуса, получения результата и отмены. Возвращаемые URL-адреса указывают на следующие действия жизненного цикла.
Рассматривайте генерацию видео как задачу в очереди
Асинхронный вызов для создания видео — это задача, а не мгновенная загрузка файла. После её отправки сохраните выбранную модель, идентификатор запроса, время создания и состояние, сообщённое статусом endpoint. Получайте результат только после того, как сервис сообщит о завершении. Если пользователь отказывается от поставленной в очередь генерации, используйте документированный процесс отмены, а не оставляйте неотслеживаемый запрос.
Это также упрощает понимание процесса тестирования. Начните с короткого промпта и контролируемой структуры запроса. Когда вы изменяете шаблон промпта или добавляете поддерживаемую опцию, сохраняйте метаданные модели и endpoint вместе с результатом. Затем ваша команда сможет определить, какая именно конфигурация привела к каждому результату.
Не задавайте поведение модели жёстко в коде
В справочной статье по данной теме приводятся подробные утверждения о качестве выходного сигнала, временных параметрах, цене, качестве звука и настройках генерации. Эти утверждения не заменяют актуальные метаданные модели OdiRouter. Не задавайте жёстко разрешение, длительность, соотношение сторон, поведение аудио или цену, если текущая документация выбранной модели OdiRouter этого не поддерживает.
Более безопасный подход прост: выберите актуальную опцию, проверьте тело запроса на соответствие этой опции, отправьте задачу и сохраните её идентификаторы жизненного цикла. Это отделяет оценку модели от надёжности приложения, которое её вызывает.
Продолжите работу с документацией OdiRouter
Начните с каталога видеомоделей OdiRouter, затем используйте model catalog API reference, чтобы проверить текущий ответ. Когда будете готовы к генерации, следуйте multimodal task-submission guide и более широкому OdiRouter introduction.
Этот рабочий процесс API преобразования текста в видео Alibaba Wan 2.5 начинается с актуальных данных OdiRouter и сохраняет состояние запроса, необходимое производственной системе.