Кратко
Qwen Image 3.0 объединяет генерацию изображений по тексту и редактирование на основе референсов в вариантах Standard (qwen-image-3.0) и Pro (qwen-image-3.0-pro). Начните с текстового промпта, выберите размер вывода, отправьте запрос на генерацию и сразу сохраните результат. Для редактирования добавьте от одного до трех референсов и явно укажите, что необходимо сохранить. В CometAPI перед развертыванием примеров вызовов проверьте фактический маршрут и совместимую схему запроса.
Ключевые моменты
- Qwen Image 3.0 API поддерживает генерацию по тексту и редактирование по референсам через Standard (qwen-image-3.0) и Pro (qwen-image-3.0-pro); нативный формат вывода — PNG.
- Доступ к Qwen Image 3.0 API возможен через CometAPI. Разработчики могут получить ключ API, проверить поддерживаемый эндпоинт и интегрировать генерацию изображений в свои приложения.
- Цены Qwen Image 3.0 API на CometAPI начинаются от $0.024/запрос, в сравнении с тарифами Alibaba Cloud в регионе Singapore от $0.030 за Standard изображение и $0.040 за Pro 1K изображение.
- Редактирование в Qwen Image 3.0 поддерживает до трех референсов через нативный API Alibaba Cloud, а генерация — от одного до шести изображений в запросе.
- Интеграция Qwen Image 3.0 API требует проверки специфичных для провайдера параметров, аутентификации, единиц тарификации и временных URL изображений перед запуском в продакшен.
Что такое Qwen Image 3.0 API?
Qwen Image 3.0 API преобразует текстовые инструкции в изображения и может трансформировать предоставленные фотографии или дизайнерские материалы. Поддерживаемые сценарии включают многоязычные постеры, фотографии для e-commerce, макеты кампаний, замену фона и композитное редактирование изображений.
Qwen Image 3.0 Standard (qwen-image-3.0) — ориентированный на стоимость базовый вариант для генерации по тексту и редактирования по референсам. Рассматривайте его в первую очередь для масштабных задач: вариации фона для e-commerce, черновики для соцсетей и исследование концепций кампаний. Например, используйте Standard, чтобы получить несколько вариантов фона для продукта, затем оцените сохранение характеристик товара и выберите версии для дальнейшей доработки.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) поддерживает генерацию и редактирование по референсам, с более дорогим нативным уровнем вывода 2K. Оценивайте его для задач, требующих качества: ключевые изображения кампаний, детальные композиции продуктов и промо-постеры. Например, протестируйте отобранную концепцию в Pro, когда важны мелкие детали или компоновка, и сравните утвержденные результаты со Standard перед тем, как увеличивать бюджет.
Как выбрать: начните со Standard для экономичных черновиков и вариаций. Тестируйте Pro по тому же брифу для требовательных финальных материалов; выбирайте его, когда измеримое улучшение оправдывает дополнительную стоимость. Ни одно из обозначений не заменяет прикладное тестирование типографики, сохранения характеристик продукта, количества объектов или точности компоновки.
| Характеристика | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Идентификатор модели | qwen-image-3.0 | qwen-image-3.0-pro |
| Генерация / редактирование | Оба | Оба |
| Референсы для редактирования | 1–3 | 1–3 |
| Изображений на запрос | 1–6 | 1–6 |
| Формат вывода | PNG | PNG |
| Площадь пикселей вывода | 512²–2048² | 512²–2048² |
| Рекомендуемая длина промпта | 4,500 tokens | 4,500 tokens |
| Основной критерий выбора | Эффективная стоимость | Оценка премиального вывода |
Какие параметры поддерживает Qwen Image 3.0 API?
Используйте эти параметры с нативным интерфейсом Alibaba Cloud, совместимым с OpenAI. Добавляйте специфичные для провайдера опции в запросы CometAPI только если выбранный маршрут их документирует.
Применимо к обоим вариантам: qwen-image-3.0 (Standard) и qwen-image-3.0-pro (Pro) поддерживают одни и те же параметры, перечисленные ниже, в нативном интерфейсе Alibaba Cloud, совместимом с OpenAI. Вариант выбирается параметром model; элементы управления генерацией и редактированием общие. Это не подразумевает идентичного качества вывода или цены и не гарантирует, что каждый маршрут CometAPI раскрывает все нативные параметры.
| Параметр | Тип / пример | Назначение |
|---|---|---|
| model | qwen-image-3.0 | Выбор Standard или Pro |
| prompt | string | Инструкция и содержимое |
| image | URL / base64 string or array | 1–3 референса для редактирования; опустите для генерации |
| size | 1024x1024 | Размер вывода; auto, где поддерживается |
| n | integer 1–6 | Количество изображений на вызов |
| negative_prompt | string | Описание нежелательных элементов |
| prompt_extend | boolean | Включить переформулирование промпта |
| prompt_extend_mode | direct / agent | Режим agent только для T2I |
| enable_thinking | boolean | Контроль рассуждений, зависит от настроек усиления |
| watermark | boolean | Необязательный водяной знак |
| seed | integer | Помощь в воспроизводимости |
Для нативных запросов соотношение сторон вывода должно оставаться между 1:8 и 8:1. Референсные изображения должны быть не более 10 МБ, каждая сторона — от 1 до 8,000 пикселей, а отношение длинной стороны к короткой — не более 10:1. Для ввода Base64 используйте data URI. Thinking требует prompt_extend=true; усиление agent поддерживает только генерацию по тексту.
Совместимый запрос на изображение размещает поля генерации на верхнем уровне JSON и форматирует размеры как 1024x1024. Нативный DashScope использует вложенные input/parameters и обычно записывает размеры как 1024*1024. Запрос, скопированный между этими эндпоинтами без конвертации, может завершиться ошибкой.
Как вызвать Qwen Image 3.0 API через CometAPI?
Этот walkthrough предполагает Python 3, терминал, совместимый с Bash, аккаунт CometAPI с доступом к модели и достаточный баланс. Первый запрос использует только поля model и prompt, показанные в примере провайдера. Документация проверена 16 октября 2026 года; эти примеры не запускались на платном аккаунте.
Создайте учетные данные
Создайте серверный ключ API в панели CometAPI. Никогда не встраивайте его в веб- или мобильный клиент.
export COMETAPI_KEY="your_api_key"python -m pip install requests
Отправьте минимальный запрос на генерацию
Разработчики могут получить доступ к Qwen Image 3.0 API в CometAPI, используя задокументированный маршрут генерации изображений. Начните с минимального запроса ниже, прежде чем добавлять необязательные параметры.
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'
Сохраняйте каждое возвращенное изображение
Сохраните следующий скрипт как generate.py и выполните python generate.py. Он отправляет запрос, обрабатывает результаты в виде URL или Base64 и записывает каждое изображение локально. Если ответ содержит информацию о задаче вместо массива data, он останавливается, а не пытается угадать эндпоинт для опроса; используйте зависящий от аккаунта асинхронный контракт для получения завершенного результата.
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"Image {index} has no URL or Base64 payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Saved {path}")
При успешном выполнении будут созданы локальные файлы изображений. Откройте их, чтобы убедиться, что они читаются и соответствуют запрошенной сцене. Сохраняйте идентификатор запроса и поля usage в серверных логах, не записывая учетные данные.
Как сгенерировать несколько изображений с Qwen Image 3.0?
В нативном интерфейсе Alibaba Cloud установите n от двух до шести для креативных вариаций. Для CometAPI включайте n только после подтверждения поддержки на выбранном маршруте. Валидируйте каждый возвращенный ресурс отдельно; увеличение n не гарантирует, что каждый результат пройдет последующую проверку.
Вы можете сгенерировать до 6 изображений в одном запросе с Qwen Image 3.0, установив параметр n. Это работает как с qwen-image-3.0, так и с qwen-image-3.0-pro, для генерации по тексту и редактирования изображений. По умолчанию возвращается только одно изображение.
Есть два основных способа: использовать графический интерфейс, если платформа предоставляет такую опцию, или вызвать API напрямую.
Генерация нескольких изображений через API
- Откройте документацию API.
- Получите ключ API в консоли QwenCloud / CometAPI.
- Выберите
qwen-image-3.0илиqwen-image-3.0-pro. - Установите
nв количество нужных изображений от1до6. - Отправьте промпт и сохраните возвращенные изображения.
Например, установите "n": 4, чтобы запросить четыре вариации одного промпта.
Пример на Python
Ниже — готовый к адаптации пример с использованием интерфейса, совместимого с OpenAI.
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "A cozy Japanese cafe on a rainy evening, " "warm glowing lights, cinematic photography, " "rich details, realistic reflections" ),
n=4,
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("Finished generating images!")
Сначала установите необходимые пакеты:
pip install openai requests
API возвращает URL изображения для каждого результата. Сгенерированные URL изображений временные, поэтому скачайте изображения незамедлительно.
Важные настройки
| Параметр | Что делает |
|---|---|
| n=4 | Генерирует четыре выходных изображения |
| model="qwen-image-3.0-pro" | Выбирает модель Pro |
| size="1024x1024" | Запрашивает квадратные изображения |
| seed=12345 | Помогает сделать результаты воспроизводимыми |
| negative_prompt | Исключает нежелательные элементы |
Максимум — шесть выходов на запрос. Помните, что запрос большего числа изображений увеличивает стоимость генерации.
Важное различие: n=4 запрашивает четыре вариации одного промпта. Если нужны четыре разных промпта, делайте отдельные запросы или автоматизируйте цикл по вашим промптам.
Как редактировать изображения с Qwen Image 3.0?
Редактирование сочетает от одного до трех референсов с инструкцией. Объясните и желаемое преобразование, и то, что не должно меняться — например, этикетка продукта, цвет, ракурс камеры или геометрия упаковки.
Следующий пример использует учетные данные Alibaba Cloud и его JSON image field for editing. Создайте региональный ключ Model Studio, получите ID рабочего пространства и настройте соответствующий эндпоинт. Не подставляйте ключ CometAPI в этот запрос.
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
Референс ниже взят напрямую из официального примера API. Это входное изображение, а не сгенерированный результат из этой статьи.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
Нативный совместимый эндпоинт использует JSON на /images/generations, а не multipart-загрузки на /images/edits. Маски и стриминг не поддерживаются. Прочитайте возвращенный массив data и сохраните каждый URL с тем же циклом скачивания, что показан выше.
Для двух референсов включите два URL в массив image и укажите их роли в промпте (например, продукт из первого изображения, интерьер из второго). Серия Qwen Image 3.0 принимает не более трех референсов; используйте другую модель или препроцессинг для более крупных наборов источников.
Сколько стоит Qwen Image 3.0 API?
Стоимость Qwen Image 3.0 API зависит от варианта модели, разрешения вывода и провайдера. Таблица ниже дополняет исходное сравнение для Alibaba Cloud в регионе Singapore тарифами CometAPI из приложенной ценовой таблицы рецензента. В приложении приведены цены в USD за изображение и скидка 20% для всех четырех сочетаний модель/разрешение. Эти ставки не были независимо проверены по реальному биллингу; подтвердите применимый прайс-лист перед использованием в продакшене.
| Позиция тарифа | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Входное референс-изображение | $0.003/image | $0.003/image | $0.0024/image для Standard и Pro |
| Успешный вывод 1K | $0.030/image | $0.040/image | Standard: $0.0240/image; Pro: $0.0320/image |
| Успешный вывод 2K | $0.030/image | $0.075/image | Standard: $0.0240/image; Pro: $0.0600/image |
| 100 успешных выводов 1K | $3.00 | $4.00 | Standard: $2.40; Pro: $3.20 за 100 выходных изображений* |
| 1,000 успешных выводов 2K | $30.00 | $75.00 | Standard: $24.00; Pro: $60.00 за 1,000 выходных изображений* |
| Единица тарификации | Вход/выход изображений | Вход/выход изображений | За каждое тарифицируемое входное референс-изображение и успешное выходное изображение, согласно приложенной таблице |
| Скидка на цену вывода в CometAPI | 20% для 1K и 2K | 20% для 1K и 2K | Ставки на вход и выход составляют 80% от соответствующих официальных цен на изображения в приложенной таблице |
*Примеры объемов выше учитывают только выходные изображения: 100 Standard 1K — $2.40 и 100 Pro 1K — $3.20; 1,000 Standard 2K — $24.00 и 1,000 Pro 2K — $60.00. Для редактирования добавьте $0.0024 за каждое тарифицируемое входное референс-изображение. Правила для неудачных задач, налоги и индивидуальные условия аккаунта не учитываются.
Используя приведенные ставки на входные и выходные изображения, оцените расходы на изображения у любого провайдера по формуле:
Итоговая стоимость = (тарифицируемые референс-изображения × цена входного изображения) + (успешные выходы × цена выходного изображения).
Для задания с тарификацией двух входных референсов и трех успешных Standard 1K выходов, расходы на изображения в Alibaba Cloud составят (2 × $0.0030) + (3 × $0.0300) = $0.0960. Соответствующие расходы в CometAPI — (2 × $0.0024) + (3 × $0.0240) = $0.0768, исходя из приведенных ставок.
CometAPI берет $0.0024 за входное референс-изображение для обоих вариантов. Цены вывода: $0.0240 за Standard изображение при 1K или 2K, $0.0320 за Pro изображение при 1K и $0.0600 за Pro изображение при 2K. Приведенная таблица указывает, что каждая ставка на вход и выход на 20% ниже соответствующей официальной цены. При одинаковом количестве тарифицируемых изображений итоговые расходы на изображения, соответственно, на 20% ниже; дополнительные сборы или условия аккаунта могут изменить итоговый счет.
Для расчета бюджета в продакшене подтвердите выбранный вариант, разрешение изображения, тарифы на референсы, число выходов на запрос и действующие скидки аккаунта перед оценкой общих расходов.
Как обрабатывать ошибки Qwen Image 3.0 API?
| Симптом | Вероятная причина | Действие |
|---|---|---|
| 401/403 | Неверный ключ или неправильный регион | Проверьте учетные данные, права и регион развертывания |
| 400 invalid image | Неверное число/тип референсов | Используйте 1–3 изображения, валидный URL/base64, поддерживаемые форматы |
| 400 invalid size | Неподдерживаемая площадь/соотношение или разделитель | Нормализуйте размеры под эндпоинт |
| Unexpected JSON | Неверный эндпоинт или контракт ответа | Логируйте поля ответа и адаптируйте парсер |
| Expired image URL | Изображение не сохранено до истечения срока | Скачайте и сохраните как можно скорее |
| Unexpected bill | Неучтенные референсы или уровень вывода | Используйте поля учета изображений и актуальный прайс-лист |
| Inconsistent brand text | Ограничения генерации | Введите контроль качества или добавляйте текст постобработкой |
FAQ
Следует ли повторить запрос Qwen Image 3.0 после таймаута?
Таймаут на клиенте не доказывает, что генерация остановилась. Сохраните идентификатор запроса или задачи, проверьте историю заданий у провайдера или документированный статус-API и определите, не появился ли уже результат, прежде чем повторно отправлять. Слепые повторы могут создать дубликаты задач и дополнительные расходы. Используйте ограниченные повторы для временных сбоев и следуйте рекомендациям по идемпотентности, если они доступны.
Как использовать локальные референсы с Qwen Image 3.0?
Для нативного совместимого интерфейса прочитайте файл как байты, закодируйте в Base64 и добавьте префикс data:image/png;base64,. Поместите эту строку целиком в image. Ввод Base64 также должен соответствовать лимитам на размер и размеры изображения; путь в локальной файловой системе не является URL, который сервис может загрузить.
Как передать параметры, специфичные для Qwen, через SDK OpenAI?
Оставьте стандартные поля изображения в обычных аргументах SDK, а расширения Model Studio, такие как image и prompt_extend, поместите внутрь extra_body. В «сырых» HTTP-запросах эти поля размещаются непосредственно на верхнем уровне JSON. Эта рекомендация относится к нативному совместимому интерфейсу; проверьте выбранный маршрут CometAPI, прежде чем проксировать специфичные для провайдера опции.
Что делать, если Qwen Image 3.0 вернул меньше изображений, чем запрошено?
Сначала сохраните успешные выходы и зафиксируйте фактическое количество. В нативном биллинге Alibaba Cloud оплата за выход взимается за успешно сгенерированные изображения. Если нужны дополнительные материалы, запрашивайте только недостающее количество после проверки ответа и записи использования; биллинг CometAPI следует сверять с его собственными условиями аккаунта.
Заключение
Qwen Image 3.0 — практичный выбор для команд, которым нужны генерация и редактирование по референсам в рамках одного семейства моделей. Используйте Standard как экономичную базу, тестируйте Pro для более требовательных задач 2K или креативных задач и оценивайте стоимость принятых результатов, а не цену за запрос. Начните с минимального вызова генерации, сохраните полученные изображения, затем добавьте редактирование или множественные выходы через соответствующий контракт провайдера. Разделяйте учетные данные и схемы запросов, явно обрабатывайте ошибки и сверяйте использование изображений с выбранным прайс-листом.