Skip to Content
МоделиQwen-Image

Семейство Qwen-Image

Модели изображений Tongyi от Alibaba, всего две. Вызываются через OpenAI-совместимый эндпоинт /v1/images/generations; и генерация по тексту, и редактирование используют этот эндпоинт.

Выбор модели

Параметры у обеих моделей полностью совпадают. Pro — старшая версия с лучшей отрисовкой текста и фактурой изображения.

ID моделей (копируйте без изменений)
Qwen-Image 3.0 Proqwen/qwen-image-3.0-proСтаршая версия
Qwen-Image 3.0qwen/qwen-image-3.0Стандартная версия

Актуальные цены см. на странице модели .

Отличия от других семейств

ГлавноеВозвращается ссылка на изображение, а не base64; ссылка перестаёт работать через 24 часа.
Qwen-ImageGPT Image, Seedream и др.
Результатdata[].url, временная ссылка Alibaba Cloud OSSdata[].b64_json
Поле референсных изображенийinput_imagesУ Seedream — image
/v1/images/editsНе поддерживаетсяПоддерживается в GPT Image

Срок действия ссылки: параметр Expires в ссылке — 24 часа после генерации. Если изображение нужно надолго, своевременно скачайте его и сохраните у себя; не записывайте ссылку напрямую в базу данных.

Текст в изображение

qwen_image.py
import urllib.request
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
 
resp = client.images.generate(
    model="qwen/qwen-image-3.0-pro",
    prompt="Красное яблоко на белом столе, рядом карточка с надписью «OfoxAI»",
    size="1024x1024",
)
 
# Возвращается временная ссылка — скачайте изображение в течение 24 часов
urllib.request.urlretrieve(resp.data[0].url, "output.png")

Размер и количество изображений

ГлавноеОбщее число пикселей должно быть от 512×512 до 2560×2560; максимум n — 6.
ПараметрЗначениеОписание
sizeШИРИНАxВЫСОТАОбщее число пикселей от 262 144 (512×512) до 6 553 600 (2560×2560); вне диапазона возвращается 400
size не указан—По замерам вывод 2048×2048
n1–6Возвращает несколько ссылок за один запрос; при 7 и больше возвращается 400

По замерам, 2560x1440 работает. Задержка: 1024×1024 — около 10–60 секунд, 2560×1440 — около 60 секунд, редактирование — около 50–100 секунд. Рекомендуется таймаут клиента 300 секунд или больше.

Редактирование и несколько референсов

ГлавноеРеференсные изображения передаются в input_images, не более 3; поле image не используется, /v1/images/edits не поддерживается.
qwen_edit.py
import base64
import urllib.request
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
 
with open("apple.jpg", "rb") as f:
    ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
 
resp = client.images.generate(
    model="qwen/qwen-image-3.0-pro",
    prompt="Сделай яблоко фиолетовым, остальное оставь без изменений",
    extra_body={"input_images": [ref]},
)
 
urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")
  • input_images — массив, каждый элемент которого является URL изображения или строкой, начинающейся с data:image/...;base64,; допустимо от 1 до 3 изображений, при большем количестве возвращается 400.
  • image — поле только для Seedream, Qwen-Image его не поддерживает.
  • Если при редактировании не указать size, по замерам вывод будет 2048×2048 и может не совпасть с исходным изображением. Чтобы сохранить размер, укажите его явно.

Другие параметры

negative_prompt (то, чего не должно быть на изображении) и prompt_extend (автоматически ли модель расширяет промпт) по замерам передаются без проблем. Определения параметров см. в официальной документации Alibaba Cloud Model Studio .

Типичные ошибки

Текст ошибки (фрагмент)ПричинаРешение
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requestsРазмер слишком мал или слишком великПриведите размер в допустимый диапазон, например 1024x1024, 2560x1440
Input should be less than or equal to 6: parameters.nn больше 6Укажите не более 6; если нужно больше, отправляйте запросы частями
supports 0~3 image content items. Got 4 image items.Больше 3 референсных изображенийСократите до 3 или меньше
does not support the /v1/images/edits endpointВызван эндпоинт редактированияИспользуйте input_images эндпоинта /v1/images/generations
Референсное изображение не учитываетсяИспользовано поле imageИспользуйте input_images
Ссылка на изображение недоступнаИстёк 24-часовой срок действия ссылкиСгенерируйте заново; получив ссылку, своевременно скачайте и сохраните изображение

qwen-image-3.0-distill в тексте ошибки — внутреннее имя модели на стороне поставщика; при вызове по-прежнему используйте ID моделей с этой страницы.

Точные тексты ошибок

Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100).
Input should be less than or equal to 6: parameters.n
Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)

Часто задаваемые вопросы

Почему Qwen-Image возвращает url, а не b64_json?

Qwen-Image возвращает временную ссылку на изображение в Alibaba Cloud OSS (data[].url), а не base64. Ссылка перестаёт работать через 24 часа, поэтому скачайте и сохраните изображение как можно скорее.

Как редактировать изображения в Qwen-Image?

Передайте input_images в /v1/images/generations (массив из 1–3 изображений, каждый элемент — URL изображения или base64, начинающийся с data:image). image — поле Seedream, Qwen-Image его не поддерживает; /v1/images/edits тоже не поддерживается.

Что делать с ошибкой Qwen-Image Image area must be between 262144 and 6553600 pixels?

Общее число пикселей должно быть от 512x512 до 2560x2560. Например, 100x100 слишком мало, а 3000x3000 слишком много. Укажите 1024x1024, 2048x2048, 2560x1440 и т. п.

Сколько изображений Qwen-Image может сгенерировать за раз?

Максимум n — 6; при 7 и больше возвращается 400. Если нужно больше, отправляйте запросы частями.

Почему ссылка на изображение Qwen-Image не открывается?

Параметр Expires в ссылке — 24 часа после генерации; после истечения срока скачать изображение нельзя, остаётся только сгенерировать его заново. Получив ссылку, своевременно скачайте изображение и сохраните его в собственном хранилище.

Обновлено
Seedream (Doubao)MAI Image