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

Цены

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

Кратко

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

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

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-max","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-max",
  "status": "queued",
  "params": {"prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 8,
  "created_at": "2026-08-30T20:01:12.345Z"
}

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-max",
  "status": "succeeded",
  "cost": 8,
  "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-max", "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-max", 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 Max API?

Qwen-Image Max — флагман линейки Qwen-Image от Alibaba: то же семейство, построенное вокруг разборчивого текста в кадре, в том числе на китайском, и редактирования по референсам, но в старшем тире качества. В genmux API Qwen-Image API отдаёт её под идентификатором «qwen-image-max». Рендер в 1K, 2K, до 4 референсных изображений за запрос и фиксированный набор соотношений сторон: 16:9, 4:3, 1:1, 3:4, 9:16.

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

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

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

Max — старший тир той же линейки, и за изображение он дороже: 1K — 8 юнитов · 2K — 9 юнитов. Набор соотношений сторон у него уже, в остальном поля запроса те же, что у 2.0, поэтому переключение — одно поле. С Nano Banana Pro размен иной: там выше доступные тиры разрешения, а Max берут тогда, когда всё решают текст в кадре и редактирование по референсам. Рендерит Max в 1K, 2K.

Почему у Qwen-Image Max меньше соотношений сторон?

Потому что вышестоящая модель отдаётся только для фиксированного набора форм: 16:9, 4:3, 1:1, 3:4, 9:16, без «auto». Соотношение вне этого списка отклоняется с ошибкой 400 validation_error, а не подгоняется приблизительно, — вы не платите за кадр, которого не заказывали. Если нужна нестандартная форма, возьмите модель, у которой она указана в таблице характеристик (GET /v1/models возвращает соотношения для каждой), либо сгенерируйте в ближайшем доступном соотношении и обрежьте.

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

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

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

16:9, 4:3, 1:1, 3:4, 9:16. Передаются в поле 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.

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

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

Почитать по теме

• MCP-сервер genmux: картинки из Claude, Cursor и OpenCode

  Ставим @genmux/mcp одной командой npx — и Claude, Cursor, OpenCode или Continue перечисляют модели, оценивают стоимость и генерируют картинки Nano Banana.

  7 сентября 2026 г.

• Лимиты и очереди в продакшен-конвейерах изображений

  Проектирование конвейера генерации, переживающего пики трафика: RPS на ключ, лимит одновременных заданий, очереди, бэкофф и расчёт пропускной способности.

  30 августа 2026 г.

• Nano Banana против Nano Banana Pro: когда доплата оправдана

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

  30 августа 2026 г.

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

Тот же ключ и тот же формат запроса — достаточно поменять поле 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 2.0 API

  qwen-image-2

  Qwen-Image 2.0 от Alibaba — модель, ориентированная на разборчивый текст внутри изображения, в том числе на китайском; принимает референсные изображения, вывод в 1K и 2K.

  от 3 юнитов ≈ 3,13 ₽ за изображение

• 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 ₽ за изображение