Z-Image Turbo LoRA API

Introduction

Z-Image Turbo LoRA Text to image makes one image from a written prompt on Alibaba's Z-Image Turbo, a 6-billion-parameter model distilled to eight sampling steps, with up to three of your own LoRA files loaded.

Choose a mode by starting material

Key features

Eight steps, seconds per image

Z-Image Turbo is distilled to eight sampling steps. In our runs the model took roughly three to ten seconds per image, which makes it practical for testing LoRA scales and prompts in quick loops.

A large library of community LoRAs

Pass the direct file link and a scale; nothing is uploaded to us in advance.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 2 credits per image ($0.02).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Character sheets

Keep a character LoRA and a seed fixed and change only the outfit, place and light between prompts. The face and build stay recognisable across the whole set, which is what a sheet needs.

Prompt guide & pro tips

Trigger word first

Most Z-Image Turbo LoRAs are trained with a trigger such as "Realism" or "Pixel art style". Put it at the very start, then describe the scene in plain sentences: who is in the frame, what they wear, where they are and what time of day it is.

Describe light, not adjectives

Name the light source, its direction and its colour: rain on the window, a warm lamp on the face, neon behind. Concrete lighting lands better than words like "cinematic", and it is the fastest way to make a realism LoRA look like a photograph.

Change one scale at a time

When stacking LoRAs, fix the seed and move one scale by about 0.2 at a time. Two style LoRAs at full strength usually fight; start the second one around 0.5 and raise it until its look appears without swallowing the first.

Draft in the shape you will publish

Pick the aspect ratio before you iterate.

API quick start

Call the Z-Image Turbo LoRA API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model alibaba/z-image-turbo-lora/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 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-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"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Z-Image Turbo LoRA API questions

All Z-Image models

Z-Image Base LoRA runs the full, slower base model for LoRAs trained on it.

• Z-Image Base LoRA APIZ-Image Base with up to three of your own LoRAsFrom 3 credits per image
• Z-Image APIPhotoreal images in about a secondFrom 2 credits per image
• Z-Image Turbo LoRA API8-step Z-Image Turbo that loads your own LoRAsFrom 2 credits per image

Other image APIs

• Qwen Image 2.1 LoRA APIQwen Image 2.1 images and edits with up to three of your LoRAsFrom 5 credits per image
• MiniMax H3 Image LoRA APIH3 stills and edits with up to three of your LoRAsFrom 7 credits per image
• Anima Turbo LoRA APIAnime art with your own style or character LoRAsFrom 3 credits per image
• Krea 2 Turbo LoRA APIKrea 2 Turbo images and restyles with your own LoRAsFrom 4 credits per image
• P-Image LoRA APIFast P-Image renders and edits with one LoRA of your ownFrom 1 credit per image
• FLUX.2 Klein 9B LoRA APIFast FLUX.2 Klein 9B that loads up to three of your LoRAsFrom 3 credits per image

More about Z-Image Turbo LoRA

Try it

Z-Image Turbo LoRA AI Image Generator onlineCreate images with Z-Image Turbo LoRA in PopNow

Docs

Z-Image Turbo LoRA model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Z-Image Turbo LoRA results without polling