z-image-spicy-pro

Text zu Bild. Öffentliche Modell-ID: z-image-spicy-pro; Basispreis: $0.020 je erfolgreich erzeugtem Bild.

APIMaster API key mit Authorization: Bearer verwenden. JSON: Content-Type: application/json; bei Multipart erzeugen cURL/requests die Boundary. https://apimaster.ai/v1 enthält bereits /v1.

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

Die Beispiele verwenden synchrone Endpunkte: Der Server wartet auf die bereits angenommene Anbieteraufgabe. Zurück kommt das endgültige Images-Ergebnis, keine Anbieter-UUID. Lesezeitlimit großzügig setzen, etwa 750 Sekunden; kein Streaming.

Parameter

Feld / Typ	Regeln und Standardwerte
model · string	Erforderlich; exakt die oben angegebene öffentliche Modell-ID.
prompt · string	Erforderliche, nicht leere Zeichenfolge mit Bildbeschreibung oder Bearbeitungsanweisung.
n · integer = 1	Optionale Ganzzahl; ausschließlich 1, Standard 1.
response_format · string = url	Optionale Zeichenfolge: url (Standard) oder b64_json.
width / height · integer = 1024	Optionale Ganzzahlen, jeweils 256–2560 Pixel; Anbieterstandard 1024 × 1024.
size · string	Optional BREITExHÖHE, etwa 512x512, oder auto. Muss zu width/height passen; ohne Größenfelder gilt der Anbieterstandard.
seed · integer | null = 0	Optionale Ganzzahl oder null, 0–2147483647, Standard 0. 0 oder null bedeutet Zufallsstartwert, keine Reproduzierbarkeitsgarantie.
prompt_extend · boolean | null = false	Optionaler boolescher Wert oder null; Standard false. true aktiviert die Erweiterung des Prompts beim Anbieter; null verwendet den Standard.
quality · standard; stream · false	Nicht unterstützt: n>1, stream=true, mask/mask_url, style, background, output_format und watermark. quality weglassen oder standard verwenden; keine zusätzliche Qualitätsstufe. Unbekannte Zusatzparameter werden abgelehnt.
resolution	Z Image akzeptiert keine Referenzbilder. size oder width/height verwenden; resolution weglassen (Altwert 1K wird ohne Größensteuerung akzeptiert).

Beispiele

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)

Antworten und Abrechnung

HTTP 200 enthält created (Unix-Sekunden) und genau einen Eintrag in data. url ist eine herunterladbare Bildadresse; zeitnah speichern. b64_json enthält Base64-Bildbytes. Auch den Bildinhalt prüfen.

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

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

Basispreise gelten pro Bild. Bestehende Kanal-, Gruppen- und Kontofaktoren bestimmen den endgültigen Betrag in Marktplatz und Verbrauchsprotokoll. Unterstützte Größen und Referenzzahlen kosten keinen separaten Aufpreis; n=1.

z-image-spicy-pro

Grenzen und Fehlerbehebung

Nicht unterstützt: n>1, stream=true, mask/mask_url, style, background, output_format und watermark. quality weglassen oder standard verwenden; keine zusätzliche Qualitätsstufe. Unbekannte Zusatzparameter werden abgelehnt.

Z Image akzeptiert keine Referenzbilder. size oder width/height verwenden; resolution weglassen (Altwert 1K wird ohne Größensteuerung akzeptiert).

Bei 400 Parameter korrigieren. Anbieterablehnungen und Fehler werden als Fehler zurückgegeben. Zeitlimit, Verbindungsabbruch oder unbekannter Beleg beweisen keine Ablehnung: Request-ID behalten, Protokoll prüfen oder Support kontaktieren, bevor ein weiterer kostenpflichtiger POST erfolgt. Angenommene Aufgaben werden nicht automatisch neu eingereicht.

---

Bild-API-Übersicht · qwen_image_edit_spicy

Anbieterspezifikation geprüft am 2026-10-30. Der Parametervertrag beschreibt den bereitgestellten APIMaster-Adapter, nicht die direkte Anbieter-API.

MuleRouter API