При поиске Wan 2.6 API вам все равно нужно ответить на несколько практических вопросов, прежде чем начать программировать. Что доступно сегодня? Что принимает и возвращает выбранная модель? Как ваше приложение будет обрабатывать задачу, которая завершится позже?
Начните с текущего model documentation.
Затем ознакомьтесь с multimodal setup guide.
OdiRouter содержит актуальную документацию для подтверждения этих сведений.
В этом руководстве этот поисковый запрос используется для описания рабочего процесса OdiRouter. Это не означает, что указанная сторонняя модель, цена, параметр или лицензия в настоящее время доступны в OdiRouter. Каталоги и сведения о моделях меняются, поэтому при принятии решения для продакшена используйте актуальную документацию OdiRouter.
Сначала проверьте доступность и соответствие требованиям
Прежде чем писать интеграцию, откройте актуальный каталог моделей и справочник по конкретной модели. Подтвердите идентификатор модели, поддерживаемые типы входных данных, тип выходных данных, схему параметров, единицы использования, ограничения квот и любые применимые условия. Знакомое название семейства моделей не даёт ответа на эти вопросы. Варианты могут принимать разные входные данные, предоставлять разные элементы управления или меняться со временем.
Начинайте с результата, которого должен достичь пользователь, а не с названия эндпоинта. Концепция только на основе промпта, кадр с опорой на изображение, редактирование, расширение и последовательность на основе референсов могут требовать разных возможностей. Зафиксируйте, какими входными данными вы располагаете, какой выходной результат вам нужен, какие ограничения по длительности или качеству важны для вашего продукта и как вы будете оценивать результат. Затем сопоставьте этот список с актуальной документацией по модели OdiRouter.
Этот короткий этап изучения может уберечь вас от разработки решения вокруг параметра из другого варианта или устаревшего примера. Это также даёт вашей команде понятное место для записи ссылки на модель и даты её проверки.
Следуйте документированному процессу работы с мультимодальными задачами
Генерация видео и другого мультимодального контента часто обрабатывается как задачи, а не как мгновенные ответы.
OdiRouter документирует этот жизненный цикл.
Прочитайте multimodal setup.
Используйте актуальный task submission reference.
Проверьте документированный task status flow.
Используйте result retrieval reference, когда задача будет готова.
Надежный клиент следует простой последовательности действий:
Аутентифицируйтесь с помощью безопасно хранимого ключа API и используйте актуальную схему запроса для выбранной модели.
Отправьте запрос на генерацию и сохраните возвращённый идентификатор задачи или запроса вместе с собственной записью о задании.
Проверяйте документированный статус, пока задача не достигнет конечного состояния. Вместо жесткого цикла опроса используйте ограниченное количество повторных попыток и задержку.
Если задача выполнена успешно, получите результат по указанному в документации пути и проверьте ответ, прежде чем показывать его пользователю.
В случае сбоя или истечения срока действия, сохраните контекст ошибки, который можно безопасно хранить, классифицируйте сбой и решите, целесообразно ли повторять попытку.
Актуальный справочный номер OdiRouter для выбранной модели определяет поля и пути. Не копируйте структуру запроса у несвязанного поставщика или из устаревшего руководства. Это упрощает сопровождение интеграции при изменении параметров модели.
Храните устойчивое состояние в своём приложении
Асинхронная генерация должна относиться к записи о задании, а не к одному запросу из браузера. Сохраняйте идентификатор, возвращённый при отправке, ссылку на выбранную модель, безопасное краткое описание запрошенных настроек, временные метки и окончательный статус. Не допускайте попадания ключей API и конфиденциальных исходных материалов в журналы приложения.
Статус, отображаемый пользователю, может быть проще, чем сведения о передаче данных. Пользователю может быть достаточно видеть, что генерация поставлена в очередь, выполняется, готова или требует внимания. Ваш бэкенд может использовать документированный ответ о статусе, чтобы решить, когда получать результат, прекратить опрос или предложить повторную попытку. Это также упрощает добавление тайм-аутов и операционного мониторинга без раскрытия внутренней реализации, специфичной для поставщика, в интерфейсе продукта.
Протестируйте процесс с входными данными, похожими на те, что используются в рабочей среде. Попробуйте короткий запрос только с текстовой подсказкой, запрос с использованием изображения в качестве ориентира, если выбранная модель это поддерживает, медленную или поставленную в очередь задачу и ожидаемый сбой валидации. В контролируемой среде сохраняйте идентификатор запроса и время ответа, чтобы команда могла отследить каждый тест без публикации конфиденциальных материалов.
Проверьте качество, стоимость и соответствие политикам перед запуском
Выполненная задача не всегда означает, что результат готов к использованию в продукте. Определите проверки приемки для медиаматериалов, необходимых вашему приложению: формат, размеры или продолжительность, если это применимо, безопасное получение результата и пользовательский опыт в случае, если выполнение задачи занимает больше времени, чем ожидалось. Не смешивайте эти проверки с маркетинговыми заявлениями о качестве модели.
Перед отображением расчетов в вашем продукте проверьте актуальное применение и цены для конкретной модели OdiRouter. Примените это же правило к поведению квот, поддерживаемым регионам, лицензиям и сведениям о сроках хранения. Если ваша разработка зависит от какой-либо конкретной функции, сделайте её проверкой при развертывании, а не предположением в вашем коде или тексте.
Предоставьте пользователям удобный путь восстановления. Объясните, когда они могут повторить попытку, когда им следует изменить ввод и где они могут получить поддержку. Это полезнее, чем обещать конкретный результат от модели, конфигурация которой может измениться.
Контрольный список для подготовки к производству
Ознакомьтесь с актуальным OdiRouter Model API overview и справочной документацией по выбранной модели.
Подтвердите доступность модели, поля запроса, поддерживаемые входные и выходные данные, тарифы или единицы использования, а также применимые условия.
Храните учетные данные API вне исходного кода и не допускайте их попадания в журналы.
Сохраните идентификатор задачи и используйте задокументированный процесс проверки статуса и получения результата.
Настройте ограниченные опросы статуса, тайм-ауты, повторы и обработку ошибок.
Проверьте итоговые медиаматериалы и честно сообщайте пользователю статус.
Повторно ознакомьтесь с актуальной документацией перед значимым релизом или сменой модели.
Часто задаваемые вопросы
Доступна ли запрашиваемая модель в настоящее время?
Проверьте актуальный каталог моделей OdiRouter и API-справочник для конкретной модели. Доступность — это актуальная характеристика продукта. Не делайте выводов о ней на основании целевой страницы стороннего сайта или старого руководства по интеграции.
Какой эндпоинт должно вызывать приложение?
Используйте эндпоинт и схему запроса, опубликованные в актуальной справочной документации OdiRouter для выбранной вами модели. multimodal task submission guide — полезная отправная точка для понимания жизненного цикла задачи. Страница конкретной модели определяет поддерживаемые параметры.
Как приложению следует обрабатывать длительную генерацию?
Сохраните возвращенный идентификатор задачи, отслеживайте задокументированный статус задачи с ограниченной частотой опросов и получайте результат только после того, как задача достигнет успешного конечного состояния. Определите политику тайм-аутов и повторных попыток для собственного приложения.
Где можно подтвердить актуальную цену или сведения об использовании?
Ознакомьтесь с актуальной документацией по модели OdiRouter и ценам, прежде чем показывать оценку или брать на себя обязательства по рабочему процессу. Цены и единицы использования могут различаться в зависимости от модели и меняться со временем.
Следующий шаг
Откройте актуальный model documentation.
Затем ознакомьтесь с multimodal setup guide. Выберите модель, которая в настоящее время задокументирована, проверьте ее контракт запроса и результата и протестируйте полный жизненный цикл задачи в контролируемой среде.