Подключение API Qwen Image 3.0 Pro: curl, Python и все параметры

Qwen Image 3.0 Pro (通义千问图像 3.0 Pro) доступна на HiAPI через два входа: текст-в-изображение qwen-image-3.0-pro/text-to-image и изображение-в-изображение qwen-image-3.0-pro/image-to-image. Она дороже стандартной версии, но взамен даёт более богатые детали и текстуры, а китайский и английский текст по-прежнему пишет точно. Ниже — готовые к запуску примеры на curl и Python, все текущие параметры и несколько моментов, на которые стоит обратить внимание перед запуском в продакшен.

Ранние имена моделей qwen-image-3.0-pro и поле size больше не работают: старое имя модели возвращает MODEL_UNAVAILABLE, а size отклоняется как неизвестное поле. Используйте два указанных выше имени модели вместе с aspect_ratio и resolution.

Сначала о цене

	1K (по умолчанию)	2K
Pro текст-в-изображение / изображение-в-изображение	$0.0497	$0.0993
Стандартная версия текст-в-изображение / изображение-в-изображение (для сравнения)	$0.0358	$0.0358

Текущие цены HiAPI, проверены 18 октября 2026 г.

Pro 1K примерно на 39% дороже стандартной версии, а 2K — примерно в 2,8 раза дороже стандартной. За 1–3 референсных изображения в режиме изображение-в-изображение доплата не взимается. За неудачные попытки деньги не списываются.

Одна реальная генерация

16:9. Надпись «深海来信» на медной табличке на столе и строка мелкого текста под ней «LETTERS FROM THE DEEP» воспроизведены буквально правильно:

High-end cinematic architectural editorial photograph inside a futuristic underwater restaurant at midnight. A vast curved observation window fills the background with deep cobalt water and luminous translucent jellyfish drifting outside. On the right, a sculptural dining table of black stone, hand-blown glass and restrained brushed brass catches a narrow beam of warm light. A small refined brass menu plaque on the table is naturally photographed and contains only the exact Chinese characters “深海来信”; directly below, the exact English words “LETTERS FROM THE DEEP”. The left third remains calm dark-blue negative space with volumetric light rays. No poster layout; this must feel like an expensive real location photographed for an architecture magazine. cinematic composition, dramatic directional lighting, rich cohesive cobalt-and-gold color grade, ultra-detailed, premium commercial finish, subtle film grain, shallow depth of field, high dynamic range, 16:9 hero composition

Сгенерировать с этим промптом →

qwen-image-3.0-pro/text-to-image, 16:9, пример изображения со страницы модели.

Запускаем первую генерацию

Подготовка: создайте API Key в консоли. Новым пользователям при регистрации начисляется 200 кредитов.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
      "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
      "aspect_ratio": "4:3",
      "resolution": "1K",
      "prompt_extend": false
    }
  }'

После получения taskId запросите результат:

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Когда data.status равен success, изображение находится в data.output[0].url. Это временная ссылка — скачайте и сохраните её сразу после получения.

Python

import os, time, requests

KEY = os.environ["HIAPI_KEY"]
BASE = "https://api.hiapi.ai/v1"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

r = requests.post(f"{BASE}/tasks", headers=H, json={
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
        "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
        "aspect_ratio": "4:3",
        "resolution": "1K",
        "prompt_extend": False,
    },
})
task_id = r.json()["data"]["taskId"]

while True:
    d = requests.get(f"{BASE}/tasks/{task_id}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

if d["status"] == "success":
    open("result.png", "wb").write(requests.get(d["output"][0]["url"]).content)
else:
    print(d)

Все параметры

Поле	Обязательное	Значения	Описание
prompt	Да	До 18000 символов	Содержание, стиль, композиция; текст, который должен появиться, заключается в кавычки
image_urls	Обязательно для изображение-в-изображение	1–3 шт.	JPEG/PNG/WEBP/BMP/GIF/TIFF, одно изображение ≤10MB, SVG не поддерживается
aspect_ratio	Нет	1:1 (по умолчанию), 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
resolution	Нет	1K (по умолчанию) / 2K	Определяет цену
output_format	Нет	png (по умолчанию) / jpeg
prompt_extend	Нет	Логическое, по умолчанию true	Автоматически переписывает промпт; если нужен текст символ в символ, установите false
negative_prompt	Нет	До 500 символов	То, чего не должно быть на изображении
seed	Нет	0–2147483647	Фиксация для воспроизводимости

Пример изображение-в-изображение:

{
  "model": "qwen-image-3.0-pro/image-to-image",
  "input": {
    "prompt": "把这张产品图修成高端杂志风格，保留瓶身形状和标签上的文字",
    "image_urls": ["https://example.com/product.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "prompt_extend": false
  }
}

Частые ошибки

Все они возвращаются синхронно при отправке с HTTP 400, задача не создаётся, деньги не списываются:

• MODEL_UNAVAILABLE: использовано старое имя модели qwen-image-3.0-pro, замените на имя с /text-to-image или /image-to-image.
• additional properties 'size' not allowed: size больше не принимается, используйте aspect_ratio плюс resolution.
• resolution: value must be one of '1K', '2K': у Pro нет 4K.
• image_urls: minItems: got 0, want 1: для изображение-в-изображение нужно передать хотя бы 1 референсное изображение.

Что учесть перед запуском в продакшен

• Отключайте prompt_extend при работе с текстом: автоматическое переписывание может изменить нужные вам символы.
• Используйте callback вместо опроса: добавьте на верхний уровень тела запроса "callback": {"url": "https://ваш-домен/hiapi/callback", "when": "final"} и дедуплицируйте по taskId.
• Защита от повторного списания: при отправке передавайте заголовок Idempotency-Key, а при повторных попытках после таймаута используйте тот же ключ.
• Своевременно сохраняйте результат: ссылки на выходные файлы истекают.

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

Как выбрать между Pro и стандартной версией?

Сначала попробуйте стандартную версию, $0.0358 за изображение, 1K и 2K по одной цене. Если деталей не хватает, переходите на Pro. О подключении стандартной версии см. Подключение API Qwen Image 3.0.

Можно ли получить 4K?

Нет, только 1K и 2K.

Сколько референсных изображений максимум?

3, без доплаты.

Можно также скопировать приведённый выше промпт подводного ресторана и сгенерировать на странице модели.