Introducción
Z-Image Texto a imagen convierte una descripción escrita en una sola imagen, normalmente en cerca de un segundo. La velocidad es la clave: hace que generar sea tan barato que se puede tratar como un bucle y no como un compromiso.
Z-Image es la familia de imagen compacta de 6B de Tongyi, ajustada para resultados fotorrealistas en cerca de un segundo y publicada como un único endpoint de texto a imagen. Cinco proporciones, PNG sin pérdida, prompts de 1.000 caracteres. Sin censura.
Funciones y aspectos destacados
Veinte iteraciones en vez de un prompt cuidadoso
A cerca de un segundo por imagen, dejas de escribir prompts a la defensiva. Escribe una línea, mira, ajusta, vuelve a mirar: el ciclo es tan corto que la intuición se construye con pruebas y no con conjeturas, y veinte intentos aquí siguen costando menos que una llamada a un modelo de acabado pesado.
Textura de instantánea, no brillo de estudio
Su registro más fuerte es el menos glamuroso: selfies en el espejo con el móvil, fluorescentes en el techo, un leve desenfoque de movimiento, pelo húmedo. Pide una instantánea y obtendrás algo que parece tomado y no renderizado, justo lo que los modelos más pesados tienden a pulir hasta hacerlo desaparecer.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 1000 caracteres, un presupuesto chico a propósito. mínimo 1 caracteres · máximo 1000 caracteres |
aspect_ratio | No | Forma de la salida: cinco valores, cuadrada por defecto, desde 16:9 apaisado hasta 9:16 vertical. |
enable_prompt_expansion | No | Desactivado por defecto, así que el prompt se usa tal como está escrito. Valor predeterminado: |
output_format | No |
|
seed | No | Entero de 0 a 2147483647 para el arranque aleatorio; si lo omites, cada ejecución saca el suyo. |
Precios
$0.01 / imagen
Casos de uso
Partir de un brief escrito
Usa este endpoint cuando quieras ver una idea escrita en muchas versiones rápidas: cada llamada devuelve un PNG sin pérdida en cerca de un segundo, en una de cinco proporciones. Guarda cada prompt que acierte junto con su seed.
Series de personajes en volumen
Retratos de personajes y escenas de rol explorados veinte direcciones a la vez, sin nada que marcar ni endpoint aparte. Cada ejecución saca su propia imagen, así que guarda los prompts que aciertan y varía el vestuario y el escenario de cláusula en cláusula.
Bocetos antes de un modelo de acabado
Encuentra la composición aquí, donde una imagen cuesta alrededor de un segundo, y lleva la redacción que funcionó a un modelo más lento y de techo más alto para la versión que se entrega. El mismo vocabulario fotográfico, sin reestructurar nada.
Contenido que parece una instantánea real
Selfies frente al espejo, fluorescentes de gimnasio y bombillas duras en el techo, encuadre casual de cámara de teléfono: el registro que parece una foto real en un feed. Pide los defectos de forma explícita: dominante de fluorescente, desenfoque de movimiento, enfoque irregular.
Guía de prompts y consejos prácticos
Mantén el brief breve y concreto
1.000 caracteres es poco presupuesto: gástalo en luz, objetivo y textura. El fotograma publicado salió de: «iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.»
Guarda el prompt junto a la imagen buena
Sin seed, las solicitudes idénticas sacan imágenes distintas. Guarda el prompt y la seed junto al archivo y cambia una sola cláusula cada vez mientras buscas algo mejor; con la seed fija, la diferencia que ves viene de esa cláusula.
Adapta el ejemplo incluido
Parte del ejemplo publicado con aspect_ratio: 1:1 y output_format: png. Cambia el sujeto y la dirección creativa, pero conserva el contrato de entrada de este modo.
iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.
Una versión cuadrada de la solicitud detrás del fotograma publicado: un brief de instantánea que nombra la fuente de luz, el desenfoque y el encuadre en lugar de pedir calidad.
Revisa el resultado antes de iterar
El límite del prompt es de 1.000 caracteres, y un prompt más largo se rechaza antes de enviar la solicitud en vez de recortarse: este modelo premia un brief breve, no una lista de planos. Cada proporción corresponde a un tamaño fijo en torno al megapíxel nativo del modelo, así que no hay selector de resolución ni forma de llegar a una imagen grande de entrega. La tipografía fina y el detalle pequeño y denso no son para lo que sirve un modelo de 6B.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png",
"enable_prompt_expansion": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.












