z-image-spicy-pro

Texto a imagen. ID público: z-image-spicy-pro; precio base: $0.020 por imagen generada correctamente.

Use una clave API de APIMaster con Authorization: Bearer. JSON: Content-Type: application/json; en multipart deje que cURL/requests genere el boundary. https://apimaster.ai/v1 ya incluye /v1.

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

Los ejemplos son síncronos: el servidor espera y consulta la tarea ya aceptada. El cliente recibe el resultado Images final, no el UUID del proveedor. Configure un tiempo de lectura amplio, por ejemplo 750 segundos; sin streaming.

Parámetros

Campo / tipo	Reglas y valores predeterminados
model · string	Obligatorio: ID público exacto indicado arriba.
prompt · string	Cadena obligatoria no vacía con la descripción o instrucción de edición.
n · integer = 1	Entero opcional: solo 1, predeterminado 1.
response_format · string = url	Cadena opcional: url (predeterminada) o b64_json.
width / height · integer = 1024	Enteros opcionales, cada uno de 256 a 2560 píxeles. Valor del proveedor: 1024 × 1024.
size · string	Opcional: ANCHOxALTO, por ejemplo 512x512, o auto. Debe coincidir con width/height; omita todas las dimensiones para usar el valor del proveedor.
seed · integer | null = 0	Entero opcional o null, 0–2147483647; predeterminado 0. 0 o null usa una semilla aleatoria, sin garantía de reproducibilidad.
prompt_extend · boolean | null = false	Booleano opcional o null; predeterminado false. true activa la reescritura y ampliación del prompt; null usa el valor predeterminado.
quality · standard; stream · false	No admitidos: n>1, stream=true, mask/mask_url, style, background, output_format y watermark. Omita quality o use standard, sin nivel adicional. Se rechazan parámetros extra desconocidos.
resolution	Z Image no acepta imágenes de referencia. Use size o width/height; omita resolution (se admite el valor antiguo 1K, sin definir dimensiones).

Ejemplos

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)

Respuestas y facturación

HTTP 200 contiene created (segundos Unix) y un único elemento en data. url es una dirección descargable; guarde pronto la imagen. b64_json contiene sus bytes en base64. Verifique también el contenido.

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

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

Precio base por imagen; los multiplicadores existentes del canal, grupo y cuenta determinan el cargo final en el mercado y los registros. Los tamaños y referencias admitidos no tienen recargo separado; n=1.

z-image-spicy-pro

Límites y solución de problemas

No admitidos: n>1, stream=true, mask/mask_url, style, background, output_format y watermark. Omita quality o use standard, sin nivel adicional. Se rechazan parámetros extra desconocidos.

Z Image no acepta imágenes de referencia. Use size o width/height; omita resolution (se admite el valor antiguo 1K, sin definir dimensiones).

Corrija los parámetros tras un error 400. Los rechazos y fallos del proveedor se devuelven como errores. Un timeout, desconexión o recibo desconocido no demuestra rechazo: conserve el ID, consulte registros o soporte antes de otro POST de pago. No se reenvían automáticamente tareas aceptadas.

---

Resumen de la API de imágenes · qwen_image_edit_spicy

Especificación del proveedor comprobada el 2026-10-30. Este contrato describe el adaptador APIMaster desplegado, no la API directa del proveedor.

MuleRouter API