Qwen Image 3

Qwen Image 3 (qwen/qwen-image-3) — модель Alibaba для генерации и редактирования картинок: точно рисует надписи в кадре — включая кириллицу — и держит мелкие детали до 10 пикселей. Два эндпоинта: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса.

Параметры

Поле	Описание
model	qwen/qwen-image-3 (или короткое qwen-image-3)
prompt	Описание изображения, обязательное
n	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
aspect_ratio	1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9; по умолчанию 1:1
resolution	1k или 2k; по умолчанию 1k
size	Явный размер WxH — альтернатива паре aspect_ratio + resolution
quality	У модели нет такой ручки: передача параметра вернёт 400

Размер у Qwen Image 3 считается от длинной стороны: 1024 пикселя на 1k и 2048 на 2k. Ходовые комбинации:

Формат	1k	2k
1:1	1024x1024	2048x2048
16:9	1024x576	2048x1152
9:16	576x1024	1152x2048
4:3	1024x768	2048x1536
4:1	1024x256	2048x512

Полный список из 26 допустимых size — поле sizes в каталоге; значение вне списка вернёт 400. Разрешения 4k у модели нет — запрос с ним тоже вернёт 400.

Примеры

Генерация по тексту

Python

import base64

img = client.images.generate(
    model="qwen/qwen-image-3",
    prompt="Афиша уличного фестиваля: крупная кириллическая типографика, трафаретный стиль, два цвета",
    extra_body={"aspect_ratio": "2:3", "resolution": "2k"},
)
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

cURL

curl https://api.mixen.ai/v1/images/generations \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-3",
    "prompt": "Афиша уличного фестиваля: крупная кириллическая типографика, трафаретный стиль, два цвета",
    "aspect_ratio": "2:3",
    "resolution": "2k"
  }'

Вертикальный постер явным размером

{
  "model": "qwen/qwen-image-3",
  "prompt": "Обложка приложения для бега: ночной город, ритм, неоновая сетка маршрута",
  "size": "1364x2048"
}

Редактирование по образцу

Модель принимает картинки-образцы (references: true), поэтому доступен /v1/images/edits с multipart/form-data:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=qwen/qwen-image-3 \
  -F image=@menu.png \
  -F prompt="Поменяй в меню цену на 450 ₽, остальное не трогай"

Ответ всегда содержит b64_json — файлы не хостятся. Оба эндпоинта отвечают синхронно; ставьте таймаут HTTP-клиента не меньше 120 секунд.

Цена

4.0108 ₽ ($0.045) за изображение — единая витринная цена из каталога. Актуальные значения — каталог.

Сильные стороны и ограничения

• Точный рендер надписей в кадре — включая кириллицу — и мелкие детали до 10 пикселей.
• Тринадцать форматов: от квадрата 1:1 до вытянутых лент 4:1 и 1:4.
• Предсказуемые размеры: длинная сторона 1024 на 1k и 2048 на 2k.
• Редактирование по образцу через /v1/images/edits, до 4 референсов.
• Разрешения 4k нет; ручки quality нет — оба параметра вернут 400.
• Работает только с баланса — в бесплатную квоту не входит.

Все модели — в каталоге. Общий порядок работы с изображениями — гайд по изображениям.