Z-Image Base LoRA API

Introduction

Z-Image Base LoRA Text to image draws one image from a written prompt with up to three of your own LoRA files loaded. It runs Z-Image, the 6-billion-parameter base model from Alibaba's Tongyi-MAI team: the non-distilled build that its makers describe as the starting point for fine-tuning and LoRA training. Pick any of nine aspect ratios.

Choose a mode by starting material

Key features

The build LoRAs are trained on

Z-Image comes in a fast distilled Turbo build and this full Base build. The publisher recommends Base for fine-tuning; a LoRA trained on it, loaded here, changed the whole look in our tests.

Three at once

Up to three LoRAs per request, each with its own scale from 0 to 4. Nothing is uploaded to us in advance and the files are not reviewed.

Photographs by default

Without a LoRA the model draws photographic images with natural skin, light and grain, and it follows long descriptive prompts closely.

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 3 credits per image ($0.03).

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

Use cases

A house style for a whole set

Load a style LoRA, keep its trigger phrase at the front and run a list of prompts. Every image in the set shares the look.

Your own trained LoRAs

If you train on Z-Image Base, test the result here at full quality without running your own GPU.

Photographic stills

Portraits, editorial and cinematic frames from sentences, in nine shapes from 21:9 to 9:21.

Prompt guide & pro tips

Write sentences

Describe the subject, clothing, place, light and lens in full sentences. In our tests the model followed details such as a coffee cup held in both hands or seagulls on a pier.

Mind the trigger phrase

Prompt adherence is strong enough that a LoRA's trigger phrase alone can change the style. Compare runs with and without the LoRA file, not just with and without the phrase.

Use Base LoRAs, not Turbo ones

A LoRA trained on Z-Image Turbo broke the image apart on this build in our test, without an error. Look for LoRAs trained on Z-Image Base.

Allow time

Base runs many more sampling steps than Turbo: in our tests a text-to-image request took 10 to 57 seconds of model time, usually around half a minute.

API quick start

Call the Z-Image Base 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-base-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-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"

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

Z-Image Base LoRA API questions

All Z-Image models

Z-Image Turbo LoRA is much faster and suits LoRAs trained for the Turbo build.

• 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
• Qwen Image 2512 LoRA APIQwen Image 2512 renders and edits with your own LoRAsFrom 5 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

More about Z-Image Base LoRA

Try it

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

Docs

Z-Image Base 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 Base LoRA results without polling