Skip to main content
POST

Поддерживаемые модели

Для плотного текста/вёрстки предпочтителен -pro. Для обычных изображений используйте qwen-image-3.0. Максимум промпта ~4.5k токенов. Имена моделей несовместимы с серией 2.0.

Authorizations

string
обязательно
Все конечные точки требуют аутентификации Bearer TokenПолучите API Key на странице управления API Key:

Body

string
обязательно
Имя модели
  • qwen-image-3.0 - Standard
  • qwen-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:4
  • 16:9 / 9:16
  • 3: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-image
  • agent - только text-to-image, более агрессивная перезапись
Недопустимые значения игнорируются.

Таблица размеров

Комбинация resolution (уровень) + size (соотношение):

Примеры использования

Text-to-image (несколько)

Плотная вёрстка с перезаписью

Image-to-image (редактирование)

Негативный промпт

Ограничения

Response

integer
Код статуса; 200 при успехе
array
Массив данных ответа

Отличия от 2.0

Примечания

  1. Асинхронность: после отправки возвращается task_id. Опрашивайте Получить статус задачи каждые 3~5 секунд; таймаут клиента ~3 минуты (2K + несколько изображений медленнее).
  2. Хранение: изображения зеркалируются на CDN платформы для долгосрочного доступа.
  3. Биллинг: за каждое доставленное изображение × уровень разрешения по фактической площади пикселей (> 2.25M пикселей = 2K). qwen-image-3.0 — одинаковая цена 1K/2K; -pro 2K = 2× 1K. При сбоях — полный возврат; опорные изображения бесплатны.
  4. Ошибки: недопустимый size/соотношение, agent при image-to-image, недоступные/слишком большие опорные → 400; лимит частоты → 429.
Запрос результатовИспользуйте Получить статус задачи для прогресса и result.images.