API Qwen Image полезен, когда приложению требуется генерация или редактирование изображений с надёжной обработкой текста. Прежде чем писать интеграцию, проверьте, какой вариант Qwen Image доступен для вашего API-ключа OdiRouter. Маршруты генерации и редактирования ожидают разные входные данные, поэтому одного названия модели недостаточно для выбора конечной точки.
Что такое Qwen Image
Qwen выпустила Qwen-Image в августе 4 года, 2025. В официальном анонсе она описывается как базовая модель изображений MMDiT с 20 млрд параметров, предназначенная для сложной отрисовки текста и точного редактирования изображений. Она обрабатывает алфавитные и логографические системы письма, включая английский и китайский. В официальной карточке модели указан Qwen/Qwen-Image в качестве идентификатора для преобразования текста в изображение, а также приведены локальные примеры, созданные с помощью Hugging Face Diffusers.
Этот локальный идентификатор не является конечной точкой OdiRouter. Для OdiRouter используйте идентификаторы моделей и схемы запросов из актуального каталога и документации API.
Сначала проверьте текущий маршрут OdiRouter
OdiRouter документирует аутентифицированный каталог по адресу GET https://api.odirouter.ai/v1/models/catalog. Вы можете осуществлять поиск по ключевым словам, поставщику, категории, способу ввода и способу вывода. Выполните эту проверку перед выбором конечной точки.
В общедоступной документации по OdiRouter в настоящее время Qwen Image Edit Plus указан как qwen-image-edit-plus. В ходе проверки общедоступная карта сайта модели не отображала отдельную страницу генерации qwen-image. Результат каталога для вашего API-ключа является актуальным источником информации о доступности. Идентификатор модели, цена или конечная точка, скопированные с другой платформы, могут иметь иной контракт в OdiRouter.
Создание и редактирование — это разные рабочие процессы.
В исходной карточке модели Qwen-Image показана генерация изображения по текстовому запросу. Qwen Image Edit Plus начинает работу с одного или нескольких входных изображений и текстовой инструкции. Переименование полезной нагрузки генерации не превратит её в действительный запрос на редактирование.
Документированный маршрут Qwen Image Edit Plus для OdiRouter принимает от одного до трёх входных изображений и одну текстовую инструкцию. Изображения могут быть общедоступными URL-адресами HTTP или HTTPS либо данными Base64. Настройки размера выходного изображения и управления промптом должны находиться в отдельном объекте параметров.
Как OdiRouter выполняет мультимодальную задачу
Для мультимодальных задач в очереди OdiRouter указывает базовый URL: https://api.odirouter.ai/model. В каждом запросе используется Authorization: Bearer YOUR_API_KEY.
Процесс выполнения задачи прост:
Отправьте задачу на конечную точку модели.
Сохраните возвращённый
request_id.Опрашивайте конечную точку статуса, пока задача не завершится или не вернёт ошибку.
Получите ответ и прочитайте результат со сгенерированным изображением.
Qwen Image Edit Plus использует следующие документированные конечные точки:
POST /v1/queue/qwen-image-edit-plusGET /v1/queue/qwen-image-edit-plus/requests/{request_id}/statusGET /v1/queue/qwen-image-edit-plus/requests/{request_id}/responsePUT /v1/queue/qwen-image-edit-plus/requests/{request_id}/cancel
Документированный запрос на редактирование
Этот запрос соответствует текущему контракту редактирования OdiRouter. Замените пример изображения и храните API-ключ на своём сервере.
curl --location "https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"input": {
"messages": [
{
"role": "user",
"content": [
{"image": "https://example.com/reference-image.webp"},
{"text": "Replace the sign text while preserving the composition and lighting."}
]
}
]
},
"parameters": {
"n": 1,
"size": "1024*1024",
"prompt_extend": true,
"watermark": false
}
}'В ответе на отправленное сообщение содержатся request_id и URL-адреса задач. Сохраните идентификатор вместе с записью задания. Сам по себе срок действия запроса не говорит о том, завершена ли работа.
Контрольный список производства
Перед присвоением идентификатора модели выполните запрос к каталогу OdiRouter.
Отделяйте генерацию текста в изображение от редактирования изображений.
Сохраните
YOUR_API_KEYв секретном ключе на стороне сервера или в переменной окружения.Перед отправкой проверяйте URL-адреса изображений, форматы и ограничения по размеру.
Записывайте
request_idи обрабатывайте состояния очереди, выполнения, завершения, отмены и ошибки.Перед добавлением необязательных параметров ознакомьтесь с документацией для конкретной модели.
Регистрируйте идентификатор модели, идентификатор запроса, статус и задержку. Не записывайте в журналы API-ключ или приватные данные изображений.
Перед развёртыванием в production повторно проверьте доступность и цены, поскольку содержимое каталога может измениться.
Когда подходит Qwen Image Edit Plus
Используйте документированный маршрут редактирования, если рабочий процесс начинается с существующего изображения. Типичные задачи включают замену текста, изменение стиля, объединение референсов или модификацию выбранных деталей. Для генерации только по промпту найдите в актуальном каталоге OdiRouter поддерживаемую модель преобразования текста в изображение и следуйте документации для этой конкретной конечной точки.
Начните с OdiRouter
Откройте OdiRouter model catalog и подтвердите нужные вам модель и модальность. Затем следуйте инструкциям quick start, чтобы создать API-ключ. Если маршрут редактирования соответствует вашей задаче, используйте Qwen Image Edit Plus API reference и протестируйте полный цикл отправки, проверки статуса и получения ответа, прежде чем переносить его в production.