alibaba/z-image-turbo-lora/editFrom 2 credits per image· Edit Image

Z-Image Turbo LoRA image-to-image restyles one source image with up to three of your own LoRAs. A strength from 0 to 1 (default 0.8) sets how far it moves from the source, and the output keeps the source's aspect ratio.

Call it with the model name alibaba/z-image-turbo-lora/edit on POST /jobs/createTask, from 2 credits per image ($0.02). New accounts get 30 free credits to try it in the Playground first.

  • Create Image
  • Edit Image
  • Up to 1.5K
  • 9 aspect ratios
  • Loads your own LoRA

Introduction

Z-Image Turbo LoRA Image to image redraws one source image on Alibaba's Z-Image Turbo, guided by your prompt and up to three of your own LoRA files. A strength value from 0 to 1 decides how far the result moves from the source. The output keeps the source's aspect ratio, comes back as JPEG, PNG or WebP, and is not filtered.

Choose a mode by starting material

What you haveMode
a picture to restyleZ-Image Turbo LoRA Image to image
a written description onlyZ-Image Turbo LoRA Text to image

Key features

Strength you can reason about

The default 0.8 keeps composition and pose and replaces the style; in our tests 0.6 barely changed the picture, and values near 1 kept only a loose memory of the source. Pick strength first, then refine the prompt.

Style LoRAs do the restyling

A painting LoRA turned a stage photo into an oil painting, and a Realism LoRA turned a drawing into a photograph, both with the pose intact. The prompt describes the scene; the LoRA supplies the medium.

Request parameters

ParameterRequiredDescription
image_urlYesThe picture to start from.
lorasNoLoad your own LoRA files to lock in a style or character. Default: []
output_formatNoFile type of the result. jpeg · png · webp · Default: jpeg
promptYesDescribe the image you want back, not just the change.
resolutionNoOutput size. Bigger sizes look sharper and cost more. 1k · 1.5k · Default: 1k
seedNoReuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647
strengthNoHow far the result may move away from your input. ≥ 0 · ≤ 1 · Default: 0.8

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.

OptionCredits per image≈ USD
Standard1.8$0.018

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

Photo to painting, drawing to photo

Turn product shots, portraits or sketches into another medium while the layout stays put. A painting LoRA repaints a photo; a realism LoRA turns a drawing into something that looks shot on a camera.

Consistent looks across a set

Run a folder of images through the same LoRA, strength and seed to give them one shared style, for example a catalogue of product photos redrawn as watercolour or a gallery of portraits in one film look.

Prompt guide & pro tips

Describe the whole result

Write what the final image should contain, including the subject, the clothing and the setting, not only the change. The model regenerates the entire frame, so anything you leave out of the prompt is left to chance.

Start at 0.8, then move in steps of 0.1

If the source bleeds through too much, raise strength; if the pose or the face drifts, lower it. Keep the seed fixed while you compare so that strength is the only thing changing between two results.

Put the trigger word first

Style LoRAs expect their trigger at the start of the prompt, exactly as in text-to-image. Without it, a painting or pixel-art LoRA often shows only faintly.

Send a clean source

A sharp source with one clear subject restyles best. Crop away borders, watermarks and text first; the model redraws whatever it sees, including things you did not mean to keep.

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/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-turbo-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 Turbo LoRA API questions

How much does the Z-Image Turbo LoRA API cost?

Z-Image Turbo LoRA starts at 2 credits ($0.02) per image with Edit Image, its cheapest task. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.

What is the model name for Z-Image Turbo LoRA in the API?

Put alibaba/z-image-turbo-lora/text-to-image for Create Image; alibaba/z-image-turbo-lora/edit for Edit Image in the model field of POST /jobs/createTask.

Which LoRAs work here?

Files trained for Z-Image Turbo. Hugging Face lists hundreds of them; pass the direct download link to the .safetensors file. LoRAs made for FLUX, SDXL or Qwen-Image will not transfer.

What does strength do on image-to-image?

It sets how far the result may move from the source. The default 0.8 keeps layout and pose while changing the style; at 0.6 the change is subtle; values near 1 treat the source as a loose guide.

Can I stack several LoRAs?

Yes, up to three per request, each with its own scale. Start additional LoRAs around 0.5; two style LoRAs at full strength usually compete.

What are the limits of the Z-Image Turbo LoRA API?

Resolutions: 1K · 1.5K; Prompt length (characters): 5,000; Largest upload: 10 MB. Requests outside these limits are rejected before anything is charged.

Can I try Z-Image Turbo LoRA without writing code?

Yes. The Playground runs Z-Image Turbo LoRA on your PopNow credits, needs no API key, and shows the matching code for every run.

All Z-Image models

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

More about Z-Image Turbo LoRA