01Router

Z-Image Turbo API

Tongyi Z-Image Turbo: sub-second, very low-cost photoreal images with bilingual text.

Alibaba·ImageAvailable

from$0.0035/ image$0.003910% off

Model IDz-image-turbo

Try in PlaygroundView API
text-to-imagefast

Input

Text

Output

Image

Provider

7 providers

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4

Images

1 – 4

Seed

0 – 2147483647

Last 7 days · not enough recent requests for stats yet.

Z-Image Turbo pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

OptionPrice (USD)
All options
$0.0045 / image
1 Credits

Try Z-Image Turbo before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider
Image
Estimated cost

Input

prompt
aspect_ratio
num_images
seed

Result

Idle
Your generation will appear here.

Provider prices for this request

Enter a prompt to compare provider prices.

Z-Image Turbo prompt examples

Ready-to-use prompts. Load one into the playground and tweak it.

Source
Scene

15 prompts

A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted wi

A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted wi

A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of dried flowers, seed pods, and rusted bottle caps. The focus is razor-sharp on the texture of the skin, showing every pore, wrinkle, and scar that tells a story of survival. The background is a blurred, smoky hut interior, with the warm glow of a cooking fire reflecting in the subject's dark, soulful eyes. Shot on a Leica M6 with Kodak Portra 400 film grain aesthetic.

A translucent jellyfish made of flowing liquid fire and smoke, floating inside a cube

A translucent jellyfish made of flowing liquid fire and smoke, floating inside a cube

A translucent jellyfish made of flowing liquid fire and smoke, floating inside a cube of solid ice. The ice is melting, dripping water that turns into gold coins. Stark contrast between the warm orange fire and cold blue ice. Studio lighting, black background, 3D render style, caustics lighting effects, refraction, octane render, 8k.

Cinematic wide shot of a battle-worn viking warrior standing in a blizzard. Wearing in

Cinematic wide shot of a battle-worn viking warrior standing in a blizzard. Wearing in

Cinematic wide shot of a battle-worn viking warrior standing in a blizzard. Wearing intricate silver armor with fur cloak. Face covered in mud and war paint. Snowflakes landing on eyelashes. Intense gaze, screaming. Epic mountain background, overcast sky, desaturated colors, gritty texture, highly detailed armor, 8k, Arri Alexa camera.

Show more

Z-Image Turbo API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1
llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "z-image-turbo",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "num_images": 1
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

POST
/api/v1/generations

Create a generation (charges credits) · API key required

GET
/api/v1/generations/{id}

Get a generation; polls the provider while running · API key required

POST
/api/v1/generations/{id}/cancel

Cancel a running generation (credits refunded) · API key required

POST
/api/v1/quote

Price a request on every provider (no charge, no key needed) · Public · no key

POST
/api/v1/images/generations

OpenAI-compatible image generation (waits for the result) · API key required

GET
/api/v1/models/z-image-turbo

Get one model · Public · no key

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

NameTypeRequiredDescription
modelstringYes"z-image-turbo"
providerstringNoPin a provider; omit to auto-route to the cheapest. One of: fal | 01router | wavespeed | kie | apimart | evolink | atlascloud
inputobjectYesModel parameters, see the input fields below.
callback_urlstringNoOptional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

NameTypeRequiredValuesDefault
prompt*stringYes——
aspect_ratiostringNo1:1 | 16:9 | 9:16 | 4:3 | 3:41:1
num_imagesintegerNomin: 1 · max: 41
seedintegerNomin: 0 · max: 2147483647—
Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "z-image-turbo",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "z-image-turbo",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

NameTypeRequiredDescription
idstringYesGeneration ID. Use it to query or cancel this task.
objectstringYesgeneration
modelstringYesz-image-turbo
typestringYesimage
providerstringYesProvider
statusstringYesqueued → processing → succeeded / failed. Stop polling at either terminal state.
inputobjectYesModel parameters, see the input fields below.
outputsstring[]YesResult URLs. Empty while processing; read after succeeded and save the files promptly.
errorstring | nullYesFailure reason, or null when no failure is reported.
creditsnumberYesCredits charged for this request.
price_usdnumberYesRequest price in USD.
created_atstringYesCreation time in ISO 8601 format.
completed_atstring | nullYesCompletion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "z-image-turbo",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "num_images": 1
  }
}
JSON

OpenAI-compatible images

For OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "z-image-turbo",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON
{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/z-image-turbo"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does Z-Image Turbo compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

Z-Image TurboQwen Image 3.0GPT Image 2.5 FlareGPT Image 2.5 Sunburst
VendorAlibabaAlibabaOpenAIOpenAI
Starting price$0.0035 / image$0.019 / image$0.0053 / image$0.0053 / image
InputTextText · ImageText · ImageText · Image
Provider7 providers4 providers6 providers6 providers
Aspect ratio1:1 · 16:9 · 9:16 · 4:3 · 3:41:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:91:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:31:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3
Images1 – 41 – 41 – 41 – 4
Seed0 – 21474836470 – 2147483647——

Z-Image Turbo API FAQ

Why is Z-Image Turbo so fast and cheap?

It is a compact 6B-parameter model from Alibaba's Tongyi team that generates in about eight steps, so images come back in a few seconds at a very low price.

Does it understand Chinese?

Yes. Prompts can be English or Chinese, and it can render bilingual text inside images.

Can it edit images?

On 01router it is a text-to-image model. For editing, try Seedream 5.0 Flash or Nano Banana 2.1.

What is it good for?

Fast iteration, drafts, social images, concept exploration and high-volume generation where cost matters most.

How is it billed on 01router?

Per generated image at one of the lowest rates in the catalog; see the pricing table. Failed generations are refunded.

Related models

Other models you can call with the same API key.

Image · Alibaba

Qwen Image 3.0

Qwen Image 3.0: excellent Chinese/English text rendering, posters and precise editing.

from $0.019 / imageView API
Image · OpenAI

GPT Image 2.5 Flare

OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering.

from $0.0053 / imageView API
Image · OpenAI

GPT Image 2.5 Sunburst

OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative.

from $0.0053 / imageView API
Image · Google

Nano Banana 2.1

Google Gemini image model: consistent multi-reference editing, 1K–4K output.

from $0.018 / imageView API
Image · ByteDance

Seedream 5.0 Pro

ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.

from $0.026 / imageView API
Image · Google

Nano Banana 2

Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K.

from $0.036 / imageView API