Z-Image Base LoRA API

Introduction

Z-Image Base LoRA Image to image redraws one source image on Z-Image, the 6-billion-parameter base model from Alibaba's Tongyi-MAI team, with up to three of your own LoRA files loaded. A strength control sets how far the result moves from the source. The output keeps the source's aspect ratio.

Choose a mode by starting material

Key features

One strength dial

Strength runs from 0 to 1 (default 0.7). Below 0.6 the source comes back nearly unchanged; from about 0.75 the scene is re-posed and re-staged with the same light and palette.

Two resolution tiers

1k returns a long side of 1,024 pixels and 1.5k a long side of 1,536 pixels, in the source's own aspect ratio.

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

Variations of a shot

At 0.75 to 0.8 the model keeps the light and mood of a photo but redraws the pose and setting, which is useful for alternate takes.

Testing a trained LoRA on real images

Check how a LoRA you trained on Z-Image Base treats real photographs before you build on it.

Prompt guide & pro tips

Describe the whole picture

Write the image you want back, not the change. "A woman in a green velvet dress singing on a dark stage" works; "make it black and white" alone did not in our tests.

Let the LoRA do the restyling

Without a LoRA, instructions to change the medium or the outfit changed little below 0.8. A style LoRA changed the medium at 0.6.

Pick the strength by the job

0.6 for a restyle that keeps everything in place, 0.7 for small content changes, 0.75 to 0.8 for a new take on the scene, 0.85 and above for a new picture.

Use Base LoRAs

A LoRA trained on Z-Image Turbo broke the image on this build in our test. Use files trained on Z-Image Base.

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/edit 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/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "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