Qwen Image Edit Plus

qwen-image-edit-plus Qwen Image Edit Plus ориентирована на редактирование изображений по инструкциям с сильным контролем объектов, текста и субъектов. Она полезна для практических правок, требующих семантического понимания изображения.

Эндпоинты

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 # Отменить задачу

Параметры запроса

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": "Turn the subject in the image into a cyberpunk style while preserving the original composition and details."
            }
          ]
        }
      ]
    },
    "parameters": {
      "n": 1,
      "size": "1024*1024",
      "prompt_extend": true,
      "watermark": false
    }
  }'

input object required

Объект входных параметров.

messages array required

Массив содержимого запроса. Сейчас поддерживается только один ход диалога, поэтому массив должен содержать ровно один объект со свойствами role и content.

role string required

Роль отправителя сообщения. Значение должно быть user.

content array required

Содержимое сообщения. Передайте 1-3 изображения в формате {"image": "..."} и одну инструкцию редактирования в формате {"text": "..."}.

image string required

URL входного изображения или данные в кодировке Base64. Поддерживается передача 1-3 изображений.

Для multi-image входа порядок массива задает порядок изображений, а соотношение сторон вывода следует последнему изображению.

Форматы изображений: JPG, JPEG, PNG, BMP, TIFF, WEBP и GIF.

Выходное изображение имеет формат PNG. Для анимированных GIF обрабатывается только первый кадр.

Разрешение изображения: для лучшего результата рекомендуется, чтобы ширина и высота были от 384 до 3072 пикселей. Слишком низкое разрешение может привести к размытию, слишком высокое увеличит время обработки.

Размер изображения: до 10MB.

Поддерживаются публичные HTTP и HTTPS URL, например https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp.

Поддерживаются строки изображения в кодировке Base64, например data:image/jpeg;base64,GDU7MtCZz....

text string required

Положительный prompt для описания ожидаемого содержимого, стиля и композиции изображения.

Поддерживаются китайский и английский языки. Для текущей модели лимит составляет 800 токенов; лишняя часть автоматически обрезается.

Важно: поддерживается только один элемент text. Если не передать text или передать несколько элементов text, будет возвращена ошибка.

parameters object

Дополнительные параметры управления генерацией изображения.

n integer

Количество выходных изображений.

Диапазон: 1-6.

По умолчанию: 1.

negative_prompt string

Негативный prompt для описания того, чего не должно быть на изображении, и ограничения результата.

Поддерживаются китайский и английский языки. Максимальная длина: 500 символов. Каждый китайский иероглиф, буква, цифра или символ считается одним символом; лишняя часть автоматически обрезается.

Пример: low resolution, error, worst quality, low quality, incomplete, extra fingers, poor proportions и т. д.

size string

Разрешение выходного изображения в формате width*height, например 1024*1536.

Ширина и высота должны быть в диапазоне [512, 2048] пикселей.

По умолчанию общее число пикселей близко к 1024*1024, а соотношение сторон следует входному изображению или последнему входному изображению при multi-image входе.

Если задан параметр size, система использует указанную ширину и высоту как целевые значения и корректирует фактические размеры вывода до ближайших кратных 16. Например, 1033*1032 дает выход 1040*1024.

Рекомендуемые разрешения: 1:1 1024*1024, 1536*1536; 2:3 768*1152, 1024*1536; 3:2 1152*768, 1536*1024; 3:4 960*1280, 1080*1440; 4:3 1280*960, 1440*1080; 9:16 720*1280, 1080*1920; 16:9 1280*720, 1920*1080; 21:9 1344*576, 2048*872.

prompt_extend boolean

Включать ли интеллектуальное переписывание prompt. Значение по умолчанию: true. Когда параметр включен, модель оптимизирует положительный prompt (text), что может заметно улучшить простые prompt.

watermark boolean

Добавлять ли водяной знак Qwen-Image в правый нижний угол изображения.

По умолчанию: false.

seed integer

Случайное зерно. Диапазон: [0, 2147483647].

Одинаковое значение seed может сделать результат относительно стабильным. Если параметр не указан, алгоритм автоматически использует случайное зерно.

Важно: генерация вероятностная, поэтому даже одинаковый seed не гарантирует полностью идентичный результат каждый раз.

Параметры ответа

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/qwen-image-edit-plus/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции