Если вы изучаете API преобразования текста в изображение Alibaba WAN 2.5, рассматривайте запрос как начало оценки, а не как доказательство того, что какая-либо платформа в настоящее время поддерживает эту модель. Откройте OdiRouter model catalog, подтвердите модель и её задокументированные возможности, затем проведите небольшой тест, который ваша команда сможет повторить.
В результате этого процесса у вас останутся промпт, параметры, идентификатор запроса и результат, которые вы действительно проверили. Это гораздо более надёжная основа для решения об интеграции, чем страница с анонсом.
Проверьте каталог, прежде чем писать код интеграции
Каталог моделей определяет, что доступно. На странице выбранной модели проверьте идентификатор модели, поддерживаемые входные данные, поля запроса, формат вывода и все указанные ограничения. Не переносите в собственный план реализации заявления третьих лиц о цене, задержке, качестве или доступности.
OdiRouter содержит справочные материалы и примеры API генерации изображений для актуальных моделей. getting-started guide охватывает API-ключи, авторизацию, идентификаторы моделей, первые запросы и настройку SDK. Когда важны детали запроса, используйте документацию выбранной модели. Не все конечные точки преобразования текста в изображение принимают одинаковые параметры.
Используйте небольшой, повторяющийся набор подсказок.
Выбирайте промпты, похожие на материалы, которые вам нужно создавать. При создании изображений товара опишите сам продукт, материал, обстановку, состав и целевое соотношение сторон. Для маркетинговых материалов попробуйте короткую сцену без текста, вариант с визуальными ограничениями, безопасными для вашего бренда, и вариант, в котором объект имеет чёткую визуальную иерархию.
Сделайте первое сравнение узким. Изменяйте по одной переменной за раз, например, формулировку подсказки, размер выходных данных или соотношение сторон. Сохраняйте каждый входной запрос вместе с его результатом, чтобы видеть, вызвано ли изменение моделью, параметром или самим промптом.
Отправьте запрос, предусмотренный документацией для выбранной модели
OdiRouter документирует запросы к моделям, поставленные в очередь. Точная конечная точка и поля JSON зависят от выбранной модели. На странице модели может использоваться путь к очереди следующего вида:
POST https://api.odirouter.ai/model/v1/queue/<selected-model-id>
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/jsonИспользуйте его как шаблон маршрутизации, а не как запрос для копирования и вставки. Берите поля из справочника API выбранной модели. Может потребоваться текстовый запрос, однако URL-адреса эталонных изображений, ширина, высота, размер изображения, соотношение сторон, seed и формат вывода могут различаться в зависимости от конечной точки.
Не допускайте попадания API-ключей в клиентские приложения, общедоступные коллекции запросов и сгенерированные изображения. Храните ключи в серверном хранилище секретов и заменяйте их, если считаете, что один из них был раскрыт.
Ведите учёт жизненного цикла запроса
В документации к OdiRouter отображаются ответы, находящиеся в очереди, с идентификатором запроса и ссылками для просмотра статуса или получения ответа. Сохраните идентификатор запроса вместе с подсказкой и отправленными параметрами. Опрашивайте только задокументированный URL статуса или ответа для выбранной модели. Прекращайте повторные попытки, когда документация или ответ сообщает об окончательном результате.
Это делает процесс рецензирования менее загадочным. Если кто-то обнаружит дефект, вы сможете воспроизвести запрос, сравнить его с исправленным запросом и увидеть, какая версия создала ресурс.
Проверьте результат перед принятием решения о выпуске в продакшен
Оценивайте результат с точки зрения задачи, которую он должен выполнять. Для визуального материала продукта могут потребоваться точная передача материалов и чёткие границы объекта. Для рекламного изображения может потребоваться безопасная композиция и место для последующего размещения. Попросите проверяющих указать запрос, результат, видимые дефекты и то, можно ли использовать результат как есть, требуется ли редактирование или его следует отклонить.
Если в каталоге нет ожидаемой модели, выберите задокументированную модель для работы с изображениями вместо использования недокументированной конечной точки. Метод оценки остаётся тем же: проверьте страницу модели, следуйте её формату запроса, сохраните идентификатор запроса и сравните результаты, используя один и тот же набор запросов.
Продолжить в OdiRouter
Используйте OdiRouter model catalog, чтобы ознакомиться с актуальными вариантами моделей для работы с изображениями. Затем следуйте инструкциям OdiRouter getting-started guide, чтобы создать API-ключ и выполнить первый запрос. Когда тест для конкретной модели будет соответствовать вашему стандарту проверки, перенесите запрос в серверную интеграцию и сохраните запросы как набор для регрессионного тестирования.