z-image-spicy-pro

Texte vers image. Identifiant public : z-image-spicy-pro ; prix de base : $0.020 par image générée avec succès.

Utilisez une clé API APIMaster avec Authorization: Bearer. JSON : Content-Type: application/json ; pour multipart, laissez cURL/requests définir la boundary. https://apimaster.ai/v1 inclut déjà /v1.

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

Les exemples sont synchrones : le serveur attend et interroge la tâche déjà acceptée. Le client reçoit le résultat Images final, pas l’UUID fournisseur. Prévoyez un délai de lecture long, par exemple 750 secondes ; pas de streaming.

Paramètres

Champ / type	Règles et valeurs par défaut
model · string	Obligatoire : identifiant public exact indiqué ci-dessus.
prompt · string	Chaîne obligatoire non vide décrivant l’image ou la modification.
n · integer = 1	Entier facultatif : uniquement 1, valeur par défaut 1.
response_format · string = url	Chaîne facultative : url (par défaut) ou b64_json.
width / height · integer = 1024	Entiers facultatifs, chacun entre 256 et 2560 pixels. Valeur fournisseur : 1024 × 1024.
size · string	Facultatif : LARGEURxHAUTEUR, par exemple 512x512, ou auto. Doit correspondre à width/height ; omettez toutes les dimensions pour les valeurs fournisseur.
seed · integer | null = 0	Entier facultatif ou null, 0–2147483647 ; défaut 0. 0 ou null choisit une graine aléatoire, sans garantie de reproductibilité.
prompt_extend · boolean | null = false	Booléen facultatif ou null ; défaut false. true active la réécriture et l’expansion du prompt ; null utilise le défaut.
quality · standard; stream · false	Non pris en charge : n>1, stream=true, mask/mask_url, style, background, output_format et watermark. Omettez quality ou utilisez standard, sans palier supplémentaire. Les paramètres supplémentaires inconnus sont refusés.
resolution	Z Image n’accepte aucune référence. Utilisez size ou width/height ; omettez resolution (l’ancienne valeur 1K est acceptée sans régler les dimensions).

Exemples

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)

Réponses et facturation

HTTP 200 contient created (secondes Unix) et un seul élément data. url est l’adresse de téléchargement ; enregistrez rapidement l’image. b64_json contient les octets en base64. Vérifiez aussi le contenu.

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

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

Prix de base par image ; les coefficients existants du canal, du groupe et du compte déterminent le débit final dans la place de marché et les journaux. Les dimensions et références prises en charge ne coûtent pas de supplément distinct ; n=1.

z-image-spicy-pro

Limites et dépannage

Non pris en charge : n>1, stream=true, mask/mask_url, style, background, output_format et watermark. Omettez quality ou utilisez standard, sans palier supplémentaire. Les paramètres supplémentaires inconnus sont refusés.

Z Image n’accepte aucune référence. Utilisez size ou width/height ; omettez resolution (l’ancienne valeur 1K est acceptée sans régler les dimensions).

Corrigez les paramètres après une erreur 400. Les refus et échecs fournisseur sont renvoyés comme erreurs. Un délai dépassé, une déconnexion ou un reçu inconnu ne prouvent pas un refus : conservez l’ID de requête, vérifiez les journaux ou contactez le support avant un autre POST payant. Aucune nouvelle soumission automatique d’une tâche acceptée.

---

Vue d’ensemble de l’API image · qwen_image_edit_spicy

Spécification fournisseur vérifiée le 2026-10-30. Ce contrat décrit l’adaptateur APIMaster déployé, pas directement l’API fournisseur.

MuleRouter API