z-image-spicy-pro

Генерация по тексту. Публичный ID: z-image-spicy-pro; базовая цена — $0.020 за успешно созданное изображение.

Используйте API-ключ APIMaster с Authorization: Bearer. Для JSON — Content-Type: application/json; boundary multipart задаёт cURL/requests. https://apimaster.ai/v1 уже содержит /v1.

POST https://apimaster.ai/v1/images/generations · application/json

Примеры синхронные: сервер ожидает и опрашивает уже принятую задачу. Клиент получает окончательный ответ Images, а не UUID поставщика. Задайте большой тайм-аут чтения, например 750 секунд; потоковый вывод не используется.

Параметры

Поле / тип	Правила и значения по умолчанию
model · string	Обязательно: точный публичный ID выше.
prompt · string	Обязательная непустая строка: описание изображения или инструкция редактирования.
n · integer = 1	Необязательное целое: только 1, по умолчанию 1.
response_format · string = url	Необязательная строка: url (по умолчанию) или b64_json.
width / height · integer = 1024	Необязательные целые, каждое 256–2560 пикселей. По умолчанию у поставщика 1024 × 1024.
size · string	Необязательно: ШИРИНАxВЫСОТА, например 512x512, или auto. Должно совпадать с width/height. Без всех полей размера действуют значения поставщика.
seed · integer | null = 0	Необязательное целое или null, 0–2147483647; по умолчанию 0. 0 или null означает случайное зерно, без гарантии воспроизводимости.
prompt_extend · boolean | null = false	Необязательное логическое значение или null; по умолчанию false. true включает переписывание и расширение промпта; null использует стандартное поведение.
quality · standard; stream · false	Не поддерживаются: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality опустить или указать standard, без дополнительного уровня. Неизвестные дополнительные параметры отклоняются.
resolution	Z Image не принимает референсы. Используйте size или width/height; resolution опустите (старое 1K допускается без задания размера).

Примеры

cURL · JSON

curl --max-time 750 'https://apimaster.ai/v1/images/generations' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "z-image-spicy-pro",
  "prompt": "A red paper boat on a calm blue pond, no text.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "width": 512,
  "height": 512,
  "prompt_extend": false
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "z-image-spicy-pro",
    "prompt": "A red paper boat on a calm blue pond, no text.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "width": 512,
    "height": 512,
    "prompt_extend": False
}
response = requests.post(
    api_base + "/images/generations",
    headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
    json=payload,
    timeout=(20, 750),
)
response.raise_for_status()
result = response.json()
print(result)

Ответы и оплата

HTTP 200 содержит created (секунды Unix) и один элемент data. url — адрес скачивания, сохраните изображение своевременно. b64_json — байты в base64. Проверяйте также содержимое изображения.

{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}

{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}

Базовая цена за изображение; существующие коэффициенты канала, группы и аккаунта определяют итоговое списание в каталоге и журнале. Поддерживаемые размеры и число референсов не дают отдельной доплаты; n=1.

z-image-spicy-pro

Ограничения и диагностика

Не поддерживаются: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality опустить или указать standard, без дополнительного уровня. Неизвестные дополнительные параметры отклоняются.

Z Image не принимает референсы. Используйте size или width/height; resolution опустите (старое 1K допускается без задания размера).

При 400 исправьте параметры. Отказы и сбои поставщика возвращаются как ошибки. Тайм-аут, разрыв или неизвестная квитанция не доказывают отказ: сохраните ID, проверьте журнал или поддержку перед новым платным POST. Принятая задача автоматически не отправляется повторно.

---

Обзор API изображений · qwen_image_edit_spicy

Спецификация проверена 2026-10-30. Описан развёрнутый адаптер APIMaster, а не прямой API создания и опроса поставщика.

MuleRouter API