popnow
Iniciar sesiónEmpieza a crear

alibaba/z-image-turbo/text-to-imageDesde 2 créditos por imagen

Z-Image es la familia de imagen compacta de 6B de Tongyi, afinada para dar salida fotorrealista en cosa de un segundo y publicada como un único endpoint text-to-image. Cinco proporciones, PNG sin pérdida, prompts de 1000 caracteres.

Llámalo con el nombre de modelo alibaba/z-image-turbo/text-to-image en POST /jobs/createTask, desde 2 créditos por imagen (0,02 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

  • Crear imagen
  • 5 relaciones de aspecto
de AlibabaObtener clave APIEjemplos y prompts de Z-Image →

Por ahora esta guía solo está en inglés. →

Parámetros de la petición

ParámetroObligatorioDescripción
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647
promptSíDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioNoLa forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · Por defecto: 1:1
output_formatNoTipo de archivo del resultado. png · Por defecto: png
enable_prompt_expansionNoDeja que el modelo añada detalles a un prompt corto. Por defecto: false

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

OpciónCréditos por imagen≈ USD
Estándar1,50,015 US$
enable_prompt_expansion true2,40,024 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 2 créditos por imagen (0,02 US$).

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de Z-Image en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
  2. Envía la solicitud. Haz POST /jobs/createTask con model alibaba/z-image-turbo/text-to-image y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de Z-Image

¿Cuánto cuesta la API de Z-Image?

Z-Image cuesta 2 créditos (0,02 US$) por imagen. Precios por opción: Estándar 1,5 créditos por imagen, true 2,4 créditos por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de Z-Image en la API?

Pon alibaba/z-image-turbo/text-to-image para Crear imagen en el campo model de POST /jobs/createTask.

¿Qué tan rápido es Z-Image de verdad?

Alrededor de un segundo para un cuadro de text-to-image. Ese es el sentido de la familia: el ciclo es lo bastante corto como para tratar la redacción como un experimento y no como un compromiso.

¿Qué controla realmente aspect_ratio?

Las dimensiones en píxeles de la salida. Cada proporción corresponde a un tamaño fijo alrededor del megapíxel nativo del modelo, así que la calidad se mantiene pareja entre proporciones en vez de desmoronarse en los extremos.

¿Puedo reproducir una imagen anterior?

Casi, si guardaste la seed: con el mismo prompt, la misma proporción y la misma seed, el resultado queda muy cerca del cuadro anterior, aunque una seed no garantiza píxeles idénticos. Sin seed, dos solicitudes iguales devuelven cuadros distintos, así que guarda el prompt y la seed junto a cualquier recurso que quieras conservar.

¿Por qué el límite de prompt es de solo 1000 caracteres?

Es lo máximo que acepta este endpoint: un prompt más largo se rechaza antes de enviarse, no se recorta en silencio. También coincide con lo que un modelo compacto de 6B aprovecha bien: aquí una descripción apretada de sujeto, luz y textura rinde más que una lista larga de planos.

¿Qué límites tiene la API de Z-Image?

Relaciones de aspecto: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Longitud del prompt (caracteres): 1,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar Z-Image sin escribir código?

Sí. El Playground ejecuta Z-Image con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Todos los modelos de Z-Image

Z-Image Turbo LoRA ejecuta la misma familia con tus propias LoRA y añade imagen a imagen.

Más sobre Z-Image