Z-Image API: $0.008 за изображение, реальные результаты и код

Кратко

• Z-Image — это быстрая модель текст-в-изображение от Alibaba Tongyi. На HiAPI идентификатор модели — z-image, стоимость — $0.008 за изображение: 1 000 изображений за $8.
• Запрос содержит только два поля: prompt (до 1 000 символов) и aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). Нет размера, разрешения, seed или входного изображения.
• Модель хорошо справляется с фотореалистичными товарными изображениями с коротким английским текстом. Во всех четырёх тестах ниже весь текст выведен корректно. Откройте страницу модели Z-Image, чтобы попробовать; новые аккаунты получают 200 бесплатных кредитов.

Цены

Количество изображений	Стоимость z-image
1	$0.008
100	$0.80
600 (200 товаров × 3 изображения)	$4.80
1 000	$8.00

Актуальные цены HiAPI на 20 октября 2026 г. Единая цена для всех соотношений сторон. За неудачные задачи плата не взимается.

Сравнение с другими недорогими моделями на HiAPI:

Модель	За изображение	Текст на изображении
flux-schnell/text-to-image	$0.005	Не её сильная сторона
z-image	$0.008	Короткий английский текст, стабильно в наших тестах
qwen-image-2.1-turbo	$0.02	Поддерживает китайский и английский; также принимает референсные изображения
gpt-image-2/text-to-image	$0.03 при разрешении 1K	Сильный результат; также умеет редактировать изображения

Больше вариантов (включая видео) — в статье самые дешёвые API генерации изображений и видео на HiAPI.

Реальные результаты: товарные изображения с текстом

Ценник (1:1)

Студийная товарная фотография для электронной коммерции: матовая чёрная термоизолированная стальная бутылка для воды по центру на бесшовном светло-сером фоне с мягкой тенью. Прямоугольная коралловая бумажная карточка прислонена к бутылке. На карточке ТОЛЬКО эти две строки жирного аккуратного текста без засечек, и никаких других слов: первая строка "SUMMER SALE", вторая строка "$19.99". Текст расположен прямо к камере, крупный, идеально читаемый. Фотореализм.

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

z-image, 1:1, 1536×1536, $0.008.

Обе строки текста верны. Карточка в итоге оказалась на ручке бутылки, а не прислонена к ней. В первой версии этого промпта было написано "reads exactly: SUMMER SALE on the first line and $19.99 on the second line", и модель напечатала лишнее слово "ON" между строками. Заключайте точный текст в кавычки, а пояснения пишите вне кавычек.

Широкий баннер (16:9)

Широкий промо-баннер для электронной коммерции, фотореалистичная съёмка сверху: белые кроссовки и крафтовая картонная коробка на мягком синем фоне. Справа жирный тёмно-синий текст без засечек, содержащий ровно эти четыре слова и сумму, и ничего больше: "FREE SHIPPING OVER $50". Все четыре слова должны присутствовать. Текст крупный, ровный, идеально читаемый. Чистое коммерческое студийное освещение.

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

z-image, 16:9, 1344×768, $0.008.

Карточка для соцсетей (3:4)

Вертикальная товарная карточка для соцсетей: маленький коричневый стеклянный флакон-дозатор для косметики на тёплом бежевом подиуме, мягкий дневной свет. Над флаконом жирный чёрный современный заголовок без засечек, содержащий ровно: 30% OFF TODAY ONLY. Текст прямо к камере, крупный и идеально читаемый. Минималистичный премиальный стиль электронной коммерции, фотореализм.

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

z-image, 3:4, 928×1232, $0.008.

Текст верный, но дозатор перекрыл слово "ONLY". Если заголовок должен оставаться чётким, укажите положение продукта ("in the lower half, below the text" — в нижней половине, под текстом).

Мелкий текст на этикетке (3:4)

Макро-фотография товара для электронной коммерции: флакон для ухода за кожей из матового стекла с чистой белой этикеткой. Текст этикетки, напечатанный элегантным тёмным шрифтом без засечек, содержит ровно: первая строка GLOW SERUM, вторая строка VITAMIN C 10%. Прямой угол обзора, этикетка полностью видна и резкая, мягкое студийное освещение, фотореализм, белый фон.

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

z-image, 3:4, 928×1232, $0.008.

Мелкий текст на изогнутой поверхности — самое сложное из четырёх, но результат чистый. Модель разбила "VITAMIN C 10%" на две строки.

Правила корректного вывода текста

1. Заключайте точный текст в кавычки.
2. Добавляйте "and no other words" (и никаких других слов), чтобы модель не придумывала лишние надписи на бейджах.
3. Располагайте текст прямо к камере, ровно. Наклонный или изогнутый текст ошибается первым.
4. Помещайте на изображение только один-два текстовых блока. Более длинный текст верстайте позже в графическом редакторе.
5. Проверяйте каждое изображение перед публикацией. При цене $0.008 повторная генерация почти ничего не стоит.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

Вы получите taskId. Опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}, пока data.status не станет success, затем скачайте data.output[0].url. Статус последовательно проходит через queued, handling и archiving, а затем становится success или fail. Ссылка действует около 7 дней после завершения задачи.

Python: пакетная обработка

# pip install requests；сначала выполните export HIAPI_KEY=your-key
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # сначала отправляем все, затем собираем результаты

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

Параметры и ошибки

Поле	Обязательно	Значения
prompt	Да	До 1 000 символов
aspect_ratio	Нет	1:1, 4:3, 3:4, 16:9, 9:16

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

• additional properties 'size' not allowed (или resolution, width): используйте aspect_ratio.
• aspect_ratio: value must be one of ...: 21:9 и 4:5 не поддерживаются. Сначала сгенерируйте 16:9 или 3:4, затем обрежьте.
• Использование идентификатора модели вроде z-image-turbo: единственный id на HiAPI — z-image.

Когда стоит использовать другую модель

• Нужно редактировать существующее изображение: Z-Image генерирует только из текста. Используйте модель изображение-в-изображение, например qwen-image-2.1-turbo ($0.02) или gpt-image-2/image-to-image.
• Текст длинный, плотный или преимущественно китайский: попробуйте Qwen Image — она создана для двуязычной вёрстки.
• Нужна минимальная цена и не нужен текст: flux-schnell/text-to-image за $0.005.

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

Какой идентификатор модели?

z-image. На HiAPI нет отдельного id z-image-turbo; Turbo — это название быстрого варианта у поставщика.

Как получить API-ключ?

Зарегистрируйтесь на hiapi.ai, создайте ключ в консоли и передавайте его как Authorization: Bearer <key>. Один ключ подходит для всех моделей.

Умеет ли она выводить китайский текст?

Alibaba указывает двуязычный текст среди сильных сторон. Все четыре теста выше были на английском, поэтому перед тем как полагаться на это, проверьте вывод на китайском со своим промптом.

Есть ли настройка разрешения?

Нет. Размер вывода зависит от соотношения сторон: в тестах выше 1:1 дал 1536×1536, 16:9 — 1344×768, 3:4 — 928×1232.

Хотите попробовать промпт без написания кода? Откройте страницу модели Z-Image.