Qwen-Image 2.0 API — генерация изображений

Кратко

Примеры генераций

Необработанные результаты этой модели, полученные через API.

• 

  isometric data center clean vector style

Цены

Стоимость = кредиты за изображение × n. Кредиты резервируются при отправке запроса и полностью возвращаются, если генерация завершилось ошибкой или вы отменили его до начала работы.

Прайс-листы других провайдеров

Публично объявленные цены за изображение у провайдеров с сопоставимым доступом к этой модели — взяты с их собственных страниц с ценами. Провайдеры меняют цены без предупреждения, актуальную сумму смотрите по ссылке.

Быстрый старт

Создайте ключ в кабинете, отправьте запрос и опрашивайте статус генерации. Во втором запросе подставьте id, который вернул первый.

1. Отправьте запрос

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen-image-2","prompt":"a red fox in fresh snow, low winter sun","n":1,"resolution":"1K","ratio":"1:1"}'

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "qwen-image-2",
  "status": "queued",
  "params": {"prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 3,
  "created_at": "2026-08-30T20:01:12.345Z"
}

2. Опрашивайте, пока status не станет succeeded (обычно 1–20 с)

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "qwen-image-2",
  "status": "succeeded",
  "cost": 3,
  "images": [
    {"index": 0, "url": "https://…/0.png?X-Amz-Expires=900&…", "expires_at": "2026-08-30T20:16:30Z", "mime": "image/png", "width": 1024, "height": 1024, "bytes": 1843201, "sha256": "9f2c…"}
  ],
  "created_at": "2026-08-30T20:01:12.345Z",
  "finished_at": "2026-08-30T20:01:19.802Z"
}

import os, time, uuid, requests

BASE = "https://api.genmux.tech"
auth = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

job = requests.post(
    f"{BASE}/v1/generations",
    headers={**auth, "Idempotency-Key": str(uuid.uuid4())},
    json={"model": "qwen-image-2", "prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
    timeout=30,
).json()

while job["status"] in ("queued", "running"):
    time.sleep(1)
    job = requests.get(f"{BASE}/v1/generations/{job['id']}", headers=auth, timeout=30).json()

print(job["images"][0]["url"])  # presigned, valid for 15 minutes

const BASE = "https://api.genmux.tech";
const auth = { Authorization: `Bearer ${process.env.API_KEY}` };

let job = await fetch(`${BASE}/v1/generations`, {
  method: "POST",
  headers: { ...auth, "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" },
  body: JSON.stringify({ model: "qwen-image-2", prompt: "a red fox in fresh snow, low winter sun", n: 1, resolution: "1K", ratio: "1:1" }),
}).then((r) => r.json());

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 1000));
  job = await fetch(`${BASE}/v1/generations/${job.id}`, { headers: auth }).then((r) => r.json());
}

console.log(job.images[0].url); // presigned, valid for 15 minutes

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

Что такое Qwen-Image 2.0 API?

Qwen-Image 2.0 — модель генерации изображений Alibaba из линейки Qwen-Image, которую команда Qwen с самого начала строила вокруг разборчивого текста внутри изображения, включая китайские иероглифы, и вокруг редактирования по присланному изображению. В genmux API этот Qwen-Image API — идентификатор «qwen-image-2»: рендер в 1K, 2K, до 4 референсных изображений за запрос, цены — 1K — 3 кредита · 2K — 4 кредита.

Сколько стоит одно изображение Qwen-Image 2.0?

От 3 кредитов за изображение — это примерно 3,13 ₽ по цене пакета «Scale». Цена зависит от тира разрешения: 1K — 3 кредита · 2K — 4 кредита. Запрос на n изображений стоит в n раз дороже. Кредиты предоплачены: ни подписки, ни оплаты за пользователя нет.

Чем Qwen-Image 2.0 отличается от Qwen-Image Max?

Max — флагман линейки и стоит дороже за изображение; 2.0 — стандартный тир. Здесь 2.0 рендерит в 1K, 2K и принимает до 4 референсных изображений, тогда как у Max набор соотношений сторон фиксированный и более узкий. В остальном поля запроса совпадают, поэтому сравнение — это замена одного поля: прогоните обе на одном промпте и seed и сверьте таблицы характеристик.

Когда выбрать Qwen-Image 2.0, а когда Nano Banana?

Когда главное в кадре — текст: постеры, макеты упаковки, скриншоты интерфейсов, слайды, всё, где заголовок или иероглифы должны читаться. Линейка Qwen-Image создавалась под этот сценарий. Nano Banana — универсальный вариант по умолчанию; сравните таблицы цен и выбирайте по задаче. Обе принимают референсные изображения, работают с одним ключом и списываются с одного баланса.

Какие разрешения поддерживает Qwen-Image 2.0?

Разрешение задаётся тиром, а не числом пикселей: эта модель рендерит в 1K, 2K, а без поля resolution используется 1K. Тир вне этого списка отклоняется с ошибкой 400 validation_error — молча ничего не масштабируется, поэтому вы всегда знаете, по какой цене платите. Старое поле size («1024x1024») по-прежнему принимается ради уже написанных интеграций и отображается на ближайший тир и соотношение сторон.

Какие соотношения сторон доступны?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9. Передаются в поле ratio; по умолчанию 1:1. Соотношение вне списка вернёт 400 validation_error. На цену соотношение сторон не влияет — её определяет только тир разрешения.

Можно ли передавать референсные изображения (image-to-image)?

Да. Передайте images — массив публичных https-ссылок, до 4 за запрос. В этом случае промпт описывает нужную правку или вариацию, а не всю сцену, и сам промпт становится необязательным. Ссылки должны быть доступны из интернета: приватные хосты и не-https отклоняются с ошибкой 400 validation_error.

Есть ли негативный промпт?

Да. Передайте negative_prompt рядом с prompt и опишите, чего в кадре быть не должно: артефакты, текст, водяные знаки, нежелательный цвет. Дополнительной платы за это нет.

Сколько изображений можно получить за один запрос?

До 4 штук — через поле n. Каждое изображение оплачивается отдельно, поэтому n=4 в тире 1K стоит в 4 раза дороже одного. Для больших объёмов отправляйте несколько запросов: пропускную способность ограничивает лимит одновременных генераций аккаунта (по умолчанию 20), а не n.

Можно ли воспроизвести результат? Поддерживается ли seed?

Да. Передайте целочисленный seed вместе с промптом — тот же seed при том же промпте, разрешении и соотношении сторон даёт воспроизводимый результат. Это же и самый честный способ сравнить две модели между собой. Без seed каждый вызов сэмплируется заново.

Сколько времени занимает генерация и нужно ли опрашивать статус?

Обычно 1–20 секунд от отправки до статуса succeeded — зависит от тира разрешения и очереди. API асинхронный: POST /v1/generations возвращает id генерации за миллисекунды, а дальше вы либо опрашиваете GET /v1/generations/{id}, либо передаёте webhook_url, и мы сами отправим POST по завершении, повторяя с экспоненциальной задержкой до 8 попыток, пока ваш эндпоинт не вернёт 2xx. Каждая доставка подписана HMAC-SHA256 секретом вебхуков вашего аккаунта.

Что будет, если генерация не удалась?

Списания не произойдёт. Кредиты резервируются при создании генерации и возвращаются полностью, если генерация завершилась ошибкой, была отменена в очереди или модель временно недоступна (503 model_unavailable). У неудачной генерации есть объект error с кодом — например, content_policy, — по которому удобно ветвить логику.

Что защищает от двойного списания при повторе запроса?

Каждый POST /v1/generations требует заголовок Idempotency-Key. Повторная отправка с тем же ключом вернёт исходную генерацию с кодом 200 и ничего не спишет — таймаут сети можно безопасно ретраить. Тот же ключ с другим телом запроса отклоняется с ошибкой 422 idempotency_key_mismatch.

Можно ли использовать изображения в коммерческих целях?

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

Другие модели

Тот же ключ и тот же формат запроса — достаточно поменять поле model.

• Nano Banana API

  nanobanana

  Быстрая универсальная генерация изображений по тексту и по референсам в 1K — через один HTTP-эндпоинт. Оплата в кредитах за изображение, при неудаче кредиты возвращаются автоматически.

  от 2 кредитов ≈ 2,09 ₽ за изображение

• Nano Banana Pro API

  nanobanana-pro

  Генерация изображений повышенной детализации — для главных визуалов и крупных кадров под печать, с выводом в 1K, 2K и 4K. В тире 1K примерно вдвое дороже базовой модели.

  от 4 кредитов ≈ 4,17 ₽ за изображение

• Qwen-Image Max API

  qwen-image-max

  Qwen-Image Max — флагман линейки Qwen-Image от Alibaba: приём референсных изображений, вывод в 1K и 2K и фиксированный набор из пяти соотношений сторон.

  от 8 кредитов ≈ 8,34 ₽ за изображение

• Seedream 5.0 API

  seedream-5

  ByteDance Seedream 5.0 — модель высокого разрешения для фотореалистичных кадров и текста в кадре; отдаётся только в 2K и 4K. Принимает референсные изображения, оплата в кредитах за изображение.

  от 16 кредитов ≈ 16,68 ₽ за изображение

• Wan 2.7 Image API

  wan-2-7-image

  wan2.7-image из линейки Tongyi Wanxiang (Alibaba) — генерация по тексту и по референсам в 1K и 2K, через тот же эндпоинт и API-ключ, что и остальной каталог.

  от 2 кредитов ≈ 2,09 ₽ за изображение