Устройство Qwen Image Edit API позволяет автоматизировать замену текста, изменение объектов, настройку стиля и редактирование изображений, содержащих более одного эталонного изображения. OdiRouter предоставляет Qwen Image Edit Plus с идентификатором модели qwen-image-edit-plus. API выполняет задачи асинхронно: отправьте запрос, проверьте его статус, получите готовое изображение или отмените задачу, если она больше не нужна.
Это руководство посвящено текущему контракту запросов OdiRouter и деталям, которые часто вызывают проблемы при интеграции.
Модель и API, доступные через OdiRouter
OdiRouter указывает Qwen Image Edit Plus как модель изображений. Его API использует следующий базовый URL:
https://api.odirouter.ai/modelЖизненный цикл задачи использует четыре эндпоинта:
Отправьте задачу с помощью
POST /v1/queue/qwen-image-edit-plus.Проверьте статус с помощью
GET /v1/queue/qwen-image-edit-plus/requests/{request_id}/status.Получите результат с помощью
GET /v1/queue/qwen-image-edit-plus/requests/{request_id}/response.Отмените задачу с помощью
PUT /v1/queue/qwen-image-edit-plus/requests/{request_id}/cancel.
Отправляйте Authorization: Bearer YOUR_API_KEY с каждым запросом. Если схема изменится, используйте OdiRouter API reference в качестве единственного источника достоверной информации.
Для чего предназначен Qwen Image Edit
В официальном релизе Qwen описывает Qwen-Image-Edit как модель редактирования, построенную на базе 20B Qwen-Image. Она использует Qwen2.5-VL для семантического управления и энкодер VAE для управления внешним видом.
Это различие полезно учитывать при планировании редактирования. Редактирование внешнего вида нацелено на отдельную деталь и при этом старается не затрагивать остальную часть изображения. Семантическое редактирование может повернуть объект, изменить стиль или внести более масштабное изменение, сохраняя узнаваемость объекта.
Официальные материалы по модели также охватывают редактирование китайского и английского текста. Типичные варианты использования включают упаковку, вывески, плакаты, макеты интерфейсов и локализованные материалы для кампаний. Результат всё равно необходимо проверить. В одном официальном примере исправление редкого китайского иероглифа потребовало нескольких последовательных правок. Мелкий текст, редкие символы, тонкие контуры и перегруженные инструкции могут потребовать ещё одного прохода.
Отправить задание на редактирование
Тело запроса содержит одно сообщение user. Его массив content принимает изображения от 1 до 3 и ровно одну текстовую инструкцию. Изображение может представлять собой общедоступный URL-адрес HTTP или HTTPS, либо данные Base64.
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 product label with Summer Blend while keeping the bottle shape, colors, reflections, and background unchanged."
}
]
}
]
},
"parameters": {
"n": 1,
"size": "1024*1024",
"prompt_extend": true,
"watermark": false,
"seed": 42
}
}'В ответ на отправленный запрос включены следующие номера: request_id, response_url, status_url, cancel_url и queue_position. Сохраните файл request_id вместе с заданием приложения перед опросом. Первый ответ подтверждает, что задача поставлена в очередь; это не отредактированное изображение.
Ограничения, которые необходимо проверить перед отправкой запроса.
В текущей документации к модели OdiRouter перечислены следующие ограничения:
Отправьте изображения 1 на изображения 3 и ровно одну инструкцию
text.Запросы можно составлять на китайском или английском языке; их длина ограничена 800 tokens.
Поддерживаются следующие форматы входных данных: JPG, JPEG, PNG, BMP, TIFF, WEBP и GIF. Обрабатывается только первый кадр анимированного файла GIF.
Рекомендуемая ширина и высота входного изображения составляют от 384 до 3072 пикселей. Размер входного изображения может составлять до 10 MB.
Формат вывода — PNG.
Установите
nв диапазоне от 1 до 6. Значение по умолчанию — 1.Ширина и высота выходного изображения должны составлять от 512 до 2048 пикселей.
negative_promptможет содержать до 500 символов.seedдолжен быть целым числом от 0 до 2147483647.
При указании size сервис корректирует фактические размеры до ближайших значений, кратных 16. Если его не указать, выходное изображение сохраняет размеры, близкие к 1024 на 1024 пикселей, и соотношение сторон входного изображения. При наличии нескольких входных изображений последнее изображение определяет соотношение сторон выходного изображения.
Повторное использование seed может сделать результаты более стабильными, но генерация всё равно носит вероятностный характер. Один и тот же seed не гарантирует идентичные байты или идентичные пиксели.
Промпты, позволяющие контролировать редактирование
Опишите изменение и правила сохранения как отдельные части инструкции. Укажите целевой объект, замену и области, которые должны остаться нетронутыми.
Для редактирования надписи:
Replace the words "Winter Roast" with "Summer Blend". Keep the existing font weight, letter spacing, label color, bottle shape, reflections, and background unchanged.Для удаления объекта:
Remove the red mug from the table. Reconstruct the wood surface and its shadow. Do not change the laptop, notebook, camera angle, or lighting.При использовании нескольких эталонных изображений указывайте их по позиции, поскольку порядок в массиве имеет значение:
Use the person from the first image and the jacket from the second image. Keep the person's face, pose, and background from the first image.Если несвязанные области продолжают изменяться, разделите работу на отдельные задачи. Длинный промпт с несколькими изменениями и несколькими правилами сохранения выполнить сложнее, чем два сфокусированных запроса.
Необязательные параметры, которые стоит протестировать
По умолчанию для prompt_extend установлено значение true. Он позволяет сервису расширять короткий положительный промпт. Это может помочь при использовании краткой инструкции, но команде, которой необходима строгая формулировка, следует сравнить её с prompt_extend, установленным на false.
По умолчанию для watermark установлено значение false. Выберите параметр, соответствующий политике в отношении конечного актива.
negative_prompt описывает артефакты или содержимое, которые не должны отображаться. Соблюдайте позитивные указания и не превышайте лимит символов в формате 500.
Поле n определяет, сколько выходных данных запрашивает задание. Несколько результатов могут быть полезны при проверке, но они также влияют на стоимость и объём хранения. Проверьте current OdiRouter pricing, прежде чем включать запросы с несколькими результатами в повторяющийся производственный процесс.
Опросите задание и получите PNG
По возможности используйте URL-адреса, возвращённые в ответе на отправку запроса. Запрос статуса имеет следующую форму:
curl --location \
"https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus/requests/REQUEST_ID/status" \
--header "Authorization: Bearer YOUR_API_KEY"После завершения задачи получите ответ:
curl --location \
"https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus/requests/REQUEST_ID/response" \
--header "Authorization: Bearer YOUR_API_KEY"Используйте ограниченный цикл опроса с увеличивающимися интервалами. Храните идентификатор запроса в надёжном хранилище приложения, чтобы после перезапуска воркера одно и то же редактирование не отправлялось повторно. Если пользователь отменяет операцию и задачу ещё можно отменить, вызовите URL отмены, возвращённый API.
Проверки для промышленной интеграции
Убедитесь, что каждый URL удалённого изображения доступен API, либо отправьте корректные данные Base64.
Перед отправкой проверьте тип файла, размеры и ограничение 10 MB.
Отправьте одно сообщение пользователя с 1 на 3 изображений и одной текстовой инструкцией.
Не допускайте попадания API-ключей в код браузера, журналы и публичные сообщения об ошибках.
Сохраните
request_idдо запуска цикла опроса.Установите крайний срок для опроса и отдельно обрабатывайте состояния «в очереди», «выполняется», «завершено», «отменено» и «ошибка».
Скопируйте итоговый PNG в хранилище, которое вы контролируете, если возвращённый URL является временным.
Проверьте текст, логотипы, лица, руки, небольшие объекты и области, которые должны были остаться без изменений.
Применяйте проверки модерации и прав, соответствующие исходному изображению и запрошенному редактированию.
Повторно проверяйте документацию модели и OdiRouter model directory, прежде чем полагаться на изменяемые сведения о доступности или ценах.
Сделайте первый тест узким
Начните с Qwen Image Edit Plus API reference, затем подтвердите актуальную информацию на model page. Небольшое редактирование с одним чётким правилом сохранения оценить проще, чем запрос, который одновременно изменяет несколько частей изображения.