z-image/turbo
Turbo is Z-Image's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runz-image/turboInput Schema
5 parameters · 1 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | The prompt to generate an image from. |
seed | integer | Optional | The same seed and the same prompt given to the same version of the model will output the same image every time. |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 · Default: "16:9" 21:916:93:24:35:41:14:53:42:39:16 |
output_format | string | Optional | The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng |
num_inference_steps | integer | Optional | The number of inference steps to perform. · Min: 1 · Max: 8 · Default: 8 |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "z-image/turbo",
"prompt": "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.",
"aspect_ratio": "16:9",
"output_format": "png",
"num_inference_steps": 8
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Z-Image Turbo
Z-Image Turbo is a fast text-to-image model for producing polished visuals from written creative direction. It is intended for rapid concept exploration and production-style iteration across photography, illustration, product imagery, editorial graphics, and stylized scene design.
A strong prompt should describe the main subject, composition, environment, lighting, color palette, camera or rendering language, and intended mood as one coordinated brief. The Turbo route is most useful when teams need to compare several directions quickly while retaining control over canvas and reproducibility.
Highlights
- Fast visual iteration. Produces image concepts quickly enough for broad prompt and art-direction exploration.
- Prompt-led composition. Coordinates subject, setting, viewpoint, lighting, palette, and stylistic treatment from one brief.
- Detailed image synthesis. Supports realistic and illustrative rendering with attention to texture, materials, and scene structure.
- Repeatable exploration. Uses local size and seed controls to compare variations within a defined delivery format.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| Base generation | Per request | $0.005 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs creating a prompt-led image | The goal is a different media task or endpoint |
| The available inputs match the required local schema | Required source media or permissions are unavailable |
| The brief can specify subject, composition, style, and delivery | The result must be deterministic at pixel or sample level |
| The supported formats and controls match final placement | Delivery requires unsupported dimensions, codecs, or duration |
| An asynchronous generated result fits the workflow | A live, frame-synchronous, or real-time response is mandatory |
Prompt Guide
Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.
{
"prompt": "A cinematic, precisely directed scene with clear subject action, camera movement, lighting, and atmosphere",
"seed": 1,
"aspect_ratio": "21:9",
"output_format": "jpeg"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | z-image/turbo |
| Input fields | seed (integer)<br>prompt (string)<br>aspect_ratio (string; 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16)<br>output_format (string; jpeg, png)<br>num_inference_steps (integer; 1–8) |
| Required input | prompt |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
bfl/flux-1/schnellalibaba/qwen-imageideogram-ai/ideogram-v3