Acerca de Z-Image Base LoRA
Z-Image Base LoRA ejecuta el modelo base Z-Image de 6 mil millones de parámetros, del equipo Tongyi-MAI de Alibaba, con hasta tres archivos LoRA tuyos en cada solicitud. Base es la versión sin destilar que sus creadores recomiendan para el ajuste fino, así que aquí se cargan los LoRA entrenados sobre ella. Ofrece texto a imagen en nueve relaciones de aspecto e imagen a imagen con control de fuerza, sin revisión ni filtro.
Llámalo con el nombre de modelo alibaba/z-image-base-lora/text-to-image en POST /jobs/createTask, desde 3 créditos por imagen (0,03 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Por defecto: 1:1 |
loras | No | Carga tus archivos LoRA para fijar un estilo o un personaje. Por defecto: [] |
output_format | No | Tipo de archivo del resultado. jpeg · png · webp · Por defecto: jpeg |
prompt | Sí | Describe the subject, clothing, place and light in sentences. Put a LoRA trigger phrase first. |
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
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ón | Créditos por imagen | ≈ USD |
|---|---|---|
| Estándar | 2,16 | 0,022 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 3 créditos por imagen (0,03 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 Base LoRA en tres pasos
- 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.
- Envía la solicitud. Haz POST /jobs/createTask con model alibaba/z-image-base-lora/text-to-image y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- 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-base-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 Base LoRA
¿Cuánto cuesta la API de Z-Image Base LoRA?
Z-Image Base LoRA cuesta desde 3 créditos (0,03 US$) por imagen con Crear imagen, su tarea más barata. 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 Base LoRA en la API?
Pon alibaba/z-image-base-lora/text-to-image para Crear imagen; alibaba/z-image-base-lora/edit para Editar imagen en el campo model de POST /jobs/createTask.
¿Funcionan aquí los LoRA de Z-Image Turbo?
No de forma fiable. En nuestra prueba, un LoRA de pixel art entrenado sobre Turbo desarmó la imagen en esta versión, sin ningún error. Usa LoRA entrenados sobre Z-Image Base.
¿Qué fuerza debo usar en imagen a imagen?
0.6 con un LoRA de estilo conserva la composición y cambia el look. 0.7, el valor por defecto, empieza a cambiar el contenido. Desde alrededor de 0.75 se vuelve a plantear la pose de la escena; con 0.85 o más obtienes una imagen nueva con la misma luz.
¿Qué límites tiene la API de Z-Image Base LoRA?
Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Z-Image Base LoRA sin escribir código?
Sí. El Playground ejecuta Z-Image Base LoRA 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 es mucho más rápido y encaja con las LoRA entrenadas para la versión Turbo.

