Z-Image Turbo

A blazing-fast text-to-image model with high quality outputs and customizable acceleration. Z-Image Turbo generates images in as few as 1-8 inference steps, making it ideal for rapid prototyping and real-time creative workflows.

$0.005per image(~5 credits)

Text to Image“Portrait of an elderly Japanese potter at the wheel in a sunlit wooden workshop, clay-covered hands shaping a tall vase, dust in the light beams, shelves of glazed bowls behind, natural photograph, 50mm, warm tones.”

Promptrequired

Aspect Ratio

Aspect ratio of the generated image.

Resolution

Output resolution tier. 1K is about 1 megapixel, 2K about 4 megapixels. Billed per megapixel, so 2K costs four times 1K.

Output Format

The format of the generated image.

$0.005per image(~5 credits)

Output

Your result renders here.

Use Z-Image Turbo via the API

Generate with Z-Image Turbo from your own code. Async by design: submit a generation, get a run id back instantly, poll until it completes. Billed in credits at the best available provider price — from $0.005 per image.

POST /api/v1/generate/z-image-turboGet your API key →

1 — Start a generation

curl -X POST https://app.scenetra.com/api/v1/generate/z-image-turbo \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a watercolor fox in falling snow, soft light","aspect_ratio":"1:1","resolution":"1K"}'

Response (202)

{
  "runId": "run_abc123",
  "status": "PENDING",
  "model": "z-image-turbo",
  "estimatedCredits": 5,
  "statusUrl": "/api/v1/runs/run_abc123"
}

2 — Poll until COMPLETED (every 2-5 seconds)

curl https://app.scenetra.com/api/v1/runs/run_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "runId": "run_abc123",
  "status": "COMPLETED",
  "progress": { "completed": 1, "total": 1 },
  "outputs": [
    { "type": "image", "url": "https://images.scenetra.com/..." }
  ],
  "error": null,
  "estimatedCredits": 5
}

Request fields

Field	Type	Description	Default
prompt*	string	Describe the image to generate.	—
aspect_ratio	string	Aspect ratio of the generated image.1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1
resolution	string	Output resolution tier. 1K is about 1 megapixel, 2K about 4 megapixels. Billed per megapixel, so 2K costs four times 1K.1K · 2K	1K
num_images	number	How many images to generate (1-4). Billed per image.	1
output_format	string	The format of the generated image.png · jpeg	png
callbackUrl	string (https URL)	Optional. When the run finishes (completed or failed), we POST the final run status to this URL — same shape as the poll response, plus `model`, `params`, and `chargedCredits`. Best-effort; polling remains the source of truth.

Unknown fields are rejected with a helpful 400. Media fields take https URLs. There is no provider parameter — every run is routed to the cheapest capable provider automatically.

Good to know

Billing

Runs bill your account credits at provider cost with 0% markup. The submit response includes the credit estimate; failed generations are refunded automatically. Add ?dryRun=1 to get the estimate without running anything.

Errors

Errors are always { "error": { "code", "message" } } with stable codes: unauthorized, model_not_available, invalid_parameter, insufficient_credits, rate_limited. A failed run is not an HTTP error — poll responses report status: "FAILED" with the reason.

Parameters

Parameter	Type	Description	Default
Prompt*	text	Describe the image to generate.	—
Aspect Ratio	select	Aspect ratio of the generated image.1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1
Resolution	select	Output resolution tier. 1K is about 1 megapixel, 2K about 4 megapixels.1K · 2K	1K
Number of Images	select	How many images to generate per run (1-4). Billed per image.1 · 2 · 3 · 4	1

Pricing

From $0.005 per image

Pay per generation — only pay for what you use.

1K (about 1 MP)

$0.005

per image

2K (about 4 MP)

$0.02

per image

Start creating with Z-Image Turbo

Use Z-Image Turbo alongside 50+ other AI models in Scenetra's visual workflow editor. No setup required.

Get Started