Qwen Image 3.0
Генерация изображений Qwen Image 3.0
- Асинхронный режим обработки, возвращает ID задачи для последующих запросов
- Поддержка text-to-image и image-to-image (1-3 опорных изображения для редактирования)
- Поддержка разрешения 1K / 2K, до 6 изображений за запрос
- Варианты Standard и Pro (Pro сильнее для плотной вёрстки и текста)
POST
Поддерживаемые модели
Authorizations
string
обязательно
Все конечные точки требуют аутентификации Bearer TokenПолучите API Key на странице управления API Key:
Body
string
обязательно
Имя модели
qwen-image-3.0- Standardqwen-image-3.0-pro- Pro (плотный текст / вёрстка)
string
обязательно
Текстовое описание для генерации изображения, максимум ~4.5k токенов
string[]
Массив URL опорных изображений (image-to-image / редактирование), 1-3 изображения
- Публичный
http(s)://URL илиdata:image/png;base64,...(base64 сначала перезаливается) - Форматы: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- На файл ≤ 10MB; ширина/высота рекомендуется 384-2048 px
string
по умолчанию:"1K"
Уровень разрешения (влияет на тарификацию)
1K(по умолчанию; допускается нижний регистр)2K
size (например, 1600x900). При сырых пикселях площадь > 2.25M пикселей тарифицируется как 2K.string
по умолчанию:"1:1"
Соотношение сторон или явный размер в пикселяхПоддерживаемые соотношения:
1:1(по умолчанию)4:3/3:416:9/9:163:2/2:3
16x9 или пиксели вида 1024x1024. Для произвольных пикселей каждая сторона (ширина и высота) должна быть 512–2048, соотношение 1:8 ~ 8:1.Если не заданы ни size, ни resolution, вывод фиксируется на 1024×1024.integer
по умолчанию:"1"
Число изображений, 1-6. Значения выше 6 ограничиваются до 6.
string
Негативный промпт: содержимое, которого следует избегать
boolean
по умолчанию:"false"
Интеллектуальная перезапись промптаПо умолчанию выключено для предсказуемых результатов. Установите
true, чтобы включить умную перезапись.string
Режим перезаписи (только серия 3.0; требуется
prompt_extend: true)direct- работает для text-to-image и image-to-imageagent- только text-to-image, более агрессивная перезапись
Таблица размеров
Комбинацияresolution (уровень) + size (соотношение):
Примеры использования
Text-to-image (несколько)
Плотная вёрстка с перезаписью
Image-to-image (редактирование)
Негативный промпт
Ограничения
Response
integer
Код статуса; 200 при успехе
array
Массив данных ответа
Отличия от 2.0
Примечания
- Асинхронность: после отправки возвращается
task_id. Опрашивайте Получить статус задачи каждые 3~5 секунд; таймаут клиента ~3 минуты (2K + несколько изображений медленнее). - Хранение: изображения зеркалируются на CDN платформы для долгосрочного доступа.
- Биллинг: за каждое доставленное изображение × уровень разрешения по фактической площади пикселей (> 2.25M пикселей = 2K).
qwen-image-3.0— одинаковая цена 1K/2K;-pro2K = 2× 1K. При сбоях — полный возврат; опорные изображения бесплатны. - Ошибки: недопустимый size/соотношение,
agentпри image-to-image, недоступные/слишком большие опорные → 400; лимит частоты → 429.
Запрос результатовИспользуйте Получить статус задачи для прогресса и
result.images.