Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro — флагманская модель генерации и редактирования изображений Qwen для сложных компоновок, реалистичных деталей и многоязычного текста. Используйте точное задание или от одного до трёх референсов для создания графики, сцены с товаром или конкретного визуального изменения.

Ailoot Ultra · Картинки POST /v1/images/generations qwen/qwen-image-3-pro

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Qwen-Image-3.0 Pro — флагманская модель третьего поколения Qwen для генерации и редактирования изображений. Она объединяет создание сложных компоновок, подробные реалистичные текстуры, многоязычную типографику и точное следование заданию на изображение. Pro и стандартная Qwen-Image-3.0 имеют общие документированные режимы генерации и редактирования; Pro делает акцент на качестве изображения, а стандартная версия — на балансе качества и скорости. Результат — готовое изображение.

Для насыщенной информацией графики определите содержание перед внешним видом: заголовок, вспомогательный текст, числа, иерархию и связи разделов. Полезное задание о товаре может объединять основной объект, крупные планы материалов и подписанные характеристики на одном холсте. Для учебной иллюстрации укажите понятие, структуру схемы и точные подписи, вместо того чтобы рассчитывать на придумывание моделью исходных фактов. Сложные компоновки могут также показывать несколько панелей или вложенные интерфейсы. В рамках рекомендованного максимума запроса 4 500 токенов сосредоточьтесь на том, что должно появиться и где это располагается.

Семейство 3.0 поддерживает нативную типографику на 12 языках, несколько шрифтов и более 100 художественных стилей, а также тонкие текстуры волос, кожи или ткани. Продемонстрирована отрисовка мелкого текста размером всего 10 пикселей. Это позволяет сочетать надписи с физическим материалом или текст с реалистичными изображениями. Задайте точные формулировки, цифры и язык и опишите типографическую роль каждого блока. Газетная страница или макет интерфейса остаётся картинкой, поэтому последующая редактируемая компоновка или интерактивное поведение — отдельный результат, который нужно построить на её основе.

Pro может редактировать текст внутри изображения, добавлять, удалять и перемещать элементы, менять действие основного объекта, переносить визуальный стиль и улучшать детали. Редактирование принимает от одного до трёх входных изображений с инструкцией. Их порядок определяет изображение 1, изображение 2 и изображение 3 в задании. Укажите, какой референс задаёт идентичность основного объекта, какой предоставляет объект или одежду, а какой — обстановку или позу. Конкретное редактирование называет желаемое изменение и признаки, которые должны сохраниться, облегчая сравнение результата с референсами.

Поддерживаемые форматы ввода — JPG, JPEG, PNG, BMP, TIFF, WebP и GIF; для анимированных GIF используется только первый кадр. Каждое входное изображение может иметь размер до 10 MB. Точный API производителя принимает стороны от 1 до 8 000 пикселей и отношение длинной стороны к короткой не более 10:1; рекомендуемый диапазон — 384–2 048 пикселей. Руководство по редактированию отдельно рекомендует изображения до 3 072 пикселей, поэтому рассматривайте выбор ввода как подготовку нужной детализации, а не обещание, что любое повышение разрешения улучшает результат. Для мелкого текста или особенностей материала используйте читаемый референс с подходящим кадрированием.

Результаты имеют формат PNG. Процесс производителя возвращает от одного до шести вариантов, по умолчанию один, и поддерживает общую площадь в пикселях от 512 × 512 до 2 048 × 2 048 при соотношениях сторон от 1:8 до 8:1. Бюджет площади допускает некоторые размеры неквадратных изображений, у которых длинная сторона превышает 2 048 пикселей. Если размер не указан, модель рекомендует разрешение по заданию. Выберите форму для фактического размещения, затем сравните варианты по полноте содержания, деталям объекта и типографике в предполагаемом размере показа.

Интеллектуальная переработка запроса включена по умолчанию. Прямое улучшение доступно для генерации и редактирования, а агентное улучшение уточняет запросы преобразования текста в изображение и не может использоваться для редактирования по изображению. Thinking также включён по умолчанию и требует переработки запроса; он добавляет рассуждения и время генерации. Негативные запросы обозначают нежелательные элементы, а необязательный seed помогает сделать сравнения вариантов более согласованными. Чёткое положительное задание всё равно должно определять объект, композицию и сохраняемые детали.

Практическая проверка результата сверяет точный текст, числа, порядок чтения, соответствие референсам и важные для дизайна края или текстуры. Когда конкретная часть требует исправления, сохраните удачную композицию и опишите точное изменение. Сохраняйте все выбранные изображения с запросом и референсами, поскольку места размещения результатов у производителя перестают действовать через 24 часа. Документированные режимы и ограничения Pro относятся к версии 3.0; десять референсов и нативная прозрачность, описанные для Qwen 2.1, — возможности отдельной версии.

Ailoot Ultra · Картинки POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения qwen/qwen-image-3-pro	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1K, 2K	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 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	По умолчанию—
Поле`n`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 6	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 0 Максимум элементов: 4	По умолчанию—
Поле`provider`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt
Параметр`material_types`	Контрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Расчётная единица	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Расчётная единица—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациявходное изображение	Шкала ставок—	Прогноз количества—	Расчётная единицаза входное изображение	Плата Вход · входное изображение · Оценка только для сравнения $0.006 за входное изображение
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.08 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Картинки

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Чтение другого содержимого

Читать существующие материалы, принадлежащие вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа

Поле	Тип
Поле`created`	Тип
Поле`data[].url`	Тип
Поле`data[].b64_json`	Тип
Поле`usage`	Тип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra qwen/qwen-image-3-pro

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Какие входные данные и результаты доступны?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Какие ограничения действуют?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro