API для работы с изображениями Qwen разработан для продуктов, которые создают или редактируют изображения, особенно когда текст внутри изображения имеет значение. OdiRouter предоставляет разработчикам единое место для просмотра доступных моделей, проверки актуальных цен и вызова документированных мультимодальных эндпоинтов. Перед написанием интеграции проверьте актуальный идентификатор модели. Название семейства не всегда соответствует одному постоянному эндпоинту.
Для чего создан Qwen-Image
В официальном репозитории Qwen исходная Qwen-Image описывается как базовая модель изображений MMDiT с 20 млрд параметров. Её основные задачи — генерация изображений, сложный рендеринг текста и точное редактирование изображений. В техническом отчёте описаны поэтапное обучение на изображениях с большим количеством текста и архитектура редактирования с двойным кодированием. Цель состоит в том, чтобы сохранить узнаваемость исходного изображения при внесении запрошенного изменения.
С момента первого релиза семейство получило дальнейшее развитие. В актуальном репозитории Qwen также указан Qwen-Image-2.0. Для API-клиента это делает вопрос именования практическим: поисковый термин, семейство моделей и эндпоинт платформы могут различаться. Используйте актуальный каталог OdiRouter и точную страницу модели в качестве контракта интеграции.
Официальные источники Qwen:
Проверьте текущую доступность Qwen Image API
OdiRouter документирует эндпоинт каталога для моделей, доступных текущему API-ключу. Его можно фильтровать по ключевому слову, категории, поставщику и модальности. Выполните эту проверку перед тем, как добавить идентификатор модели в производственный код.
curl --location "https://api.odirouter.ai/v1/models/catalog?keyword=qwen-image&category=image&provider=Qwen&page=1&page_size=20" \
--header "Authorization: Bearer $ODIROUTER_API_KEY"Прочитайте возвращенный идентификатор модели, описание, режимы работы и информацию о доступности. Если ожидаемая вами модель преобразования текста в изображение отсутствует, не заменяйте её на модель с похожим именем, не ознакомившись с её схемой запроса. Используйте актуальные ссылки на каталог и цены ниже.
Каталог изображений:
https://odirouter.ai/models?category=Image
Цены:
Используйте документированную конечную точку редактирования Qwen.
Текущий задокументированный идентификатор модели — qwen-image-edit-plus. OdiRouter представляет его как конечную точку для редактирования изображений. Его наличие не означает, что каждая модель генерации Qwen-Image доступна под фиксированным именем qwen-image.
Документированный базовый URL-адрес: https://api.odirouter.ai/model. В запросах используется аутентификация Bearer, а отправка задач выполняется на POST /v1/queue/qwen-image-edit-plus.
curl --location "https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"input": {
"messages": [
{
"role": "user",
"content": [
{"image": "https://example.com/reference-image.webp"},
{"text": "Replace the headline with SUMMER SALE and keep the product layout unchanged."}
]
}
]
},
"parameters": {
"n": 1,
"size": "1024*1024",
"prompt_extend": true,
"watermark": false
}
}'Документация допускает одно пользовательское сообщение с одним-тремя изображениями и одной инструкцией по редактированию. Изображения могут быть общедоступными URL-адресами или данными Base64. Документированный вывод: PNG. Ограничения на изображения и поля запроса относятся к конечной точке модели, поэтому перед тем, как закреплять их в долгосрочном клиенте, снова проверьте страницу.
Документация по текущей конечной точке:
Сохраняйте URL-адреса задач, возвращаемые OdiRouter
Мультимодальный API OdiRouter выполняет эти задачи через очередь. Успешная отправка возвращает request_id вместе с status_url, response_url и cancel_url. Сохраняйте все четыре значения вместе с записью о задаче. Их последующее восстановление требует дополнительных усилий и может скрыть изменение контракта.
Опрашивайте возвращённый URL-адрес статуса с тем же токеном Bearer. После завершения задачи запросите URL-адрес ответа и считайте сгенерированные элементы из output[].content[]. Конечная точка результатов может возвращать HTTP 202, пока обработка ещё выполняется. Используйте ограниченное число повторных попыток и увеличивающиеся интервалы между ними, вместо того чтобы считать такой ответ постоянной ошибкой.
curl --location "$STATUS_URL" \
--header "Authorization: Bearer $ODIROUTER_API_KEY"
curl --location "$RESPONSE_URL" \
--header "Authorization: Bearer $ODIROUTER_API_KEY"В документации по результатам OdiRouter указано, что ссылки на сгенерированные ресурсы в настоящее время истекают через семь дней. Скопируйте файлы, которые должны храниться дольше, в собственное хранилище до истечения срока действия ссылки. URL-адрес результата может предоставить доступ к сгенерированному файлу любому, у кого он есть, поэтому не делитесь им, если контент является приватным.
Ссылки по жизненному циклу:
Полезные проверки для продакшена
Сохраните ключ API в секретном ключе на стороне сервера. Не размещайте его в коде браузера, репозитории или в URL-адресе изображения.
Подтвердите идентификатор модели во время настройки, а затем повторно запросите каталог, если при развертывании будет обнаружена ошибка доступности.
Проверьте схему запроса для выбранной конечной точки. Модели генерации и редактирования часто ожидают разные поля.
Храните идентификатор запроса и URL-адреса жизненного цикла вместе с каждой задачей.
Настройте тайм-ауты, ограниченное число повторных попыток и возможность отмены для задач, выполняющихся слишком долго.
Копируйте любой результат, который должен пережить временную ссылку на результат.
Логируйте статус и идентификаторы запросов, но не включайте в логи учётные данные и приватные полезные нагрузки изображений.
Принимайте решение на репрезентативных изображениях
Рабочие процессы Image API Qwen имеют смысл, когда текст на изображениях или контролируемое редактирование занимают центральное место в продукте. Для постера или макета упаковки протестируйте точную формулировку, компоновку, целевой язык и оформление шрифта, которые планируете выпускать. При редактировании проверьте, остаются ли несвязанные области неизменными и принимает ли конечная точка количество и формат исходных изображений, используемые вашим продуктом.
Если в актуальном каталоге нет ожидаемой конечной точки Qwen, сравните модели изображений, которые действительно доступны. OdiRouter позволяет изучить эти варианты без создания отдельной учётной записи и отдельного процесса работы с учётными данными для каждого провайдера.
Начните с актуального каталога
Используйте актуальный каталог, чтобы подтвердить модель, подходящую для задачи, а затем ознакомьтесь с её точной документацией. Проверьте актуальную цену перед созданием учётной записи и храните API-ключ на сервере.
Каталог изображений:
https://odirouter.ai/models?category=Image
Цены:
Регистрация: