Как пользоваться API Qwen Image 2.1 Pro? Текстовое создание и редактирование изображений за 5 минут

TL;DR

• Что это: Qwen Image 2.1 Pro уже доступен в HiAPI. Откройте страницу модели, напишите промпт — и получите изображение по тексту; добавьте референсные изображения — и это уже редактирование. Один ID модели принимает до 10 референсных изображений, пять форматов уровня 2K, prompt_extend включён по умолчанию. Новым пользователям при регистрации дарится 200 кредитов.
• Сколько стоит: $0.05 за изображение (100 кредитов), оплата за успешно созданные изображения, независимо от формата, при ошибке — возврат, за референсные изображения доплаты нет; на $10 — около 200 изображений. У Turbo тот же договор — $0.02 за изображение.
• Как вызвать быстрее всего: напишите промпт на странице модели и запустите; для интеграции в продукт используйте POST https://api.hiapi.ai/v1/tasks, в model укажите qwen-image-2.1-pro.

Что такое Qwen Image 2.1 Pro? Чем новее 2.0

Генерация по тексту и редактирование используют один и тот же ID модели: если не передавать image_urls, создаётся новое изображение; если передать — изображение изменяется по референсу, переключать интерфейс не нужно.

Четыре отличия от 2.0 (в 2.0 размер задавался свободно в пикселях через size, в 2.1 — выбором формата):

• Один ID покрывает два типа задач. Генерация по тексту и редактирование используют его совместно, запросы отличаются только image_urls.
• До 10 референсных изображений. Изображения продукта и сцены можно отправить сразу, ссылаясь на них как на «изображение 1», «изображение 2».
• Пять форматов уровня 2K. 1:1 — 2048×2048, 16:9 — 2688×1536, 9:16 — 1536×2688, 4:3 — 2368×1728, 3:4 — 1728×2368; поля resolution нет.
• prompt_extend включён по умолчанию. Модель автоматически расширяет промпт; при строгой вёрстке или точном воспроизведении текста установите false.

Превратить эскиз в 3D-игрушку — это один запрос на редактирование, форма, пропорции и поза исходного изображения сохраняются:

Преврати эскизного маленького робота с референсного изображения в изысканную 3D-мультяшную игрушку: матовый белый корпус с кораллово-оранжевыми суставами, ушами и антенной, сердце на груди мягко светится розовым, глаза ярко-синие, сохрани исходную форму, пропорции и позу, мягкий студийный свет, чистый светло-серо-белый фон, оставь только самого робота.

Создать с этим промптом → Ссылка только предзаполняет промпт; после открытия загрузите эскиз и выберите формат 1:1.

Онлайн-попробовать: первое изображение за 5 шагов

1. Откройте страницу модели Qwen Image 2.1 Pro — 200 кредитов хватит на 2 изображения Pro.
2. Напишите промпт; для редактирования сначала загрузите 1–10 референсных изображений в image_urls.
3. Выберите формат или оставьте пустым, чтобы модель выбрала сама.
4. prompt_extend включён по умолчанию; для китайских постеров со строгой вёрсткой сначала отключите его.
5. Отправьте, после создания скачайте изображение.

Подключение API: 4 шага до результата

1. Создайте API Key в консоли.
2. POST https://api.hiapi.ai/v1/tasks, в model укажите qwen-image-2.1-pro.
3. Получив taskId, опрашивайте GET /v1/tasks/{taskId} или настройте callback.
4. Когда status станет success, скачайте изображение из output[0].url.

Рабочий curl: генерация по тексту

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.1-pro",
    "input": {
      "prompt": "Минималистичный китайский постер мероприятия, фон из бумаги цвета топлёного молока, в центре только три строки китайского текста, все выровнены по центру: первая строка крупным чёрным шрифтом с засечками «Весеннее чаепитие», вторая строка средним тёмно-серым шрифтом «Двадцать восьмого марта, два часа дня», третья строка мелким серым шрифтом «Чайная у южной стены, вход свободный». Равномерный межбуквенный интервал, достаточно свободного пространства по краям, кроме этих трёх строк на изображении нет никакого другого текста, графики, линий или декора, матовая печатная текстура.",
      "aspect_ratio": "3:4",
      "prompt_extend": false,
      "seed": 42
    }
  }'

ID задачи находится в data.taskId:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status проходит через queued, handling, archiving, success или fail; archiving означает, что ещё идёт упаковка, это не ошибка.

Версия на Python: создание, опрос, скачивание

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "qwen-image-2.1-pro",
    "input": {
        "prompt": "Сиба-ину в соломенной шляпе стоит на скейтборде, стиль плоской наклейки, цвета кораллово-оранжевый и морской синий, однотонный фон.",
        "aspect_ratio": "1:1",
        "seed": 42,
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(3)

if data["status"] == "success":
    with open("qwen-image.png", "wb") as f:
        f.write(requests.get(data["output"][0]["url"], timeout=60).content)
    print("saved qwen-image.png")
else:
    print(data.get("error"))

Чем отличаются генерация по тексту и редактирование: image_urls

Без image_urls создаётся совершенно новое изображение; 1 изображение — редактирование одного изображения; 2–10 — многореференсное редактирование. Референсные изображения поддерживают JPG/JPEG/PNG/BMP/TIFF/WEBP/GIF, каждое ≤10MB, ширина и высота 1–8000px, соотношение длинной и короткой сторон ≤10:1.

При нескольких изображениях порядок массива image_urls соответствует «изображению 1», «изображению 2» в промпте. Поместить этот стул в гостиную — с двумя референсами и одним промптом:

Помести дубовое кресло с подлокотниками с изображения 1 в гостиную с изображения 2, поставь кресло на световое пятно от панорамного окна на полу, ориентация как на изображении 1, добавь креслу соответствующую сцене падающую и контактную тень, сохрани стены, деревянный пол, плинтус, оконную раму и вид за окном с изображения 2 полностью неизменными, общее освещение — тёплый белый естественный боковой свет после полудня.

Создать с этим промптом → После открытия загрузите по порядку изображение 1 с креслом и изображение 2 с гостиной; если перепутать порядок, результат тоже перевернётся.

Для редактирования одного изображения также используется image_urls; у этого флакона духов меняются только материал и сцена:

На основе флакона духов с изображения 1 сделай коммерческое продуктовое фото: стекло флакона замени на матовое полупрозрачное, крышку из серебристо-серого металла замени на брашированную латунь, жидкость внутри сделай тёмно-янтарной, поставь флакон на столешницу из тёмно-зелёного мрамора, фон замени на тёпло-серую стену, боковой контровой свет слева сверху подчеркнёт силуэт флакона, сохрани форму флакона, пропорции, высоту крышки и форму области этикетки с изображения 1 неизменными.

Создать с этим промптом → После открытия загрузите исходное фото духов и выберите 1:1.

prompt_extend и прозрачный фон

prompt_extend по умолчанию true: модель расширяет короткое описание в полноценную инструкцию для изображения. Для точного воспроизведения фиксированной вёрстки, постеров с дословным текстом или если промпт уже очень подробный, установите false — модель строго выполнит исходный текст.

Прозрачный фон получается через промпт: напишите «полностью прозрачный фон, оставить только主体, без цветовых блоков фона», и выходной PNG может содержать альфа-канал. Результат чувствителен к формулировке, полная прозрачность не гарантируется; перед сдачей проверьте альфа-канал через Image.open(path).getchannel("A").getextrema(), а при необходимости стабильного прозрачного фона дополнительно удалите фон.

3 вещи, на которые обратить внимание перед запуском

1. Callback с запасным опросом. Добавьте на верхний уровень тела запроса "callback": {"url": "https://yourapp.com/hook", "when": "final"} для уведомления о финальном состоянии; callback может повторяться, дедуплицируйте по taskId и сохраняйте периодический опрос.
2. При тайм-ауте не отправляйте POST заново. Каждая отправка — новое изображение и новая оплата. Сохраняйте taskId и при сетевых сбоях запрашивайте тот же ID.
3. Явно указывайте aspect_ratio. Если не указать, выберет модель; для фиксированного соотношения укажите один из пяти. Поля resolution нет, при его передаче будет ошибка. URL результата содержит expireAt — сохраните файл сразу после получения.

Частые вопросы

Сколько референсных изображений можно передать максимум? 1–10 штук, каждое не более 10MB; при нескольких изображениях ссылайтесь на них как на «изображение 1», «изображение 2».

Можно ли выбрать 4K? Нет. Пять форматов соответствуют фиксированным размерам уровня 2K, 1:1 максимум 2048×2048.

Гарантируется ли прозрачный фон? Нет. Прозрачный фон получается через промпт; после генерации проверьте альфа-канал и при необходимости дополнительно удалите фон.

Создайте первое изображение прямо сейчас

Скопируйте промпт с эскизным роботом, откройте страницу модели Qwen Image 2.1 Pro, загрузите эскиз, выберите 1:1 и за $0.05 создайте изображение 2048×2048. Для многореференсной композиции загрузите кресло и гостиную по порядку в image_urls и запустите ещё раз. Полные параметры см. в документации по подключению.

Читайте также: Цены Qwen Image 2.1 · Qwen Image 2.1 vs GPT Image 2.5 · Большой сборник промптов Qwen Image 2.1