Z-Image-Base is a 6 billion-parameter text-to-image model with full CFG support. Supports negative prompting and fine-tuning capabilities for maximum control over image generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Idle
$0.01per run·~100 / $1
ExamplesView all
Artistic double exposure portrait. Silhouette of a serene man profile combined with a misty pine forest and flying birds. The image is high-key photography, mostly white background with soft grey and muted green tones. Dreamy, ethereal, surreal composition. The tree branches seamlessly merge with his hair and beard. Fine art photography, minimalist, sharp focus on the eye
A cinematic portrait of a charismatic man in his 40s, sitting in a dimly lit jazz club. Dramatic Rembrandt lighting casts strong shadows across his face, highlighting his rugged features. Volumetric cigarette smoke hangs in the air, catching golden light rays. A warm glow from behind illuminates the edges of his ears (subsurface scattering effect). Moody atmosphere, shallow depth of field, shot on Kodak Portra 800 film, rich colors, masterpiece.
A high-fashion editorial portrait from a magazine. A striking model with unique facial features poses outdoors in a textured tweed jacket. Film photography aesthetic, natural analog grain, muted but rich color palette. The focus is razor-sharp on her eyes, with a beautiful, soft bokeh background of an autumnal street. Elegant, sophisticated, natural pose, detailed fabric texture, Hasselblad medium format camera.
Related Models
README
Z-Image Base
Z-Image Base is a 6-billion parameter text-to-image model from Tongyi-MAI that generates photorealistic images with optional reference image guidance. Provide a text prompt alone, or add a reference image to guide the composition, style, or subject — all at an incredibly affordable price.
Why Choose This?
-
Reference image guidance Optionally provide a reference image to influence the generated output's composition, style, or subject matter.
-
Flexible output sizing Customize width and height up to 1024px for any aspect ratio you need.
-
Strength control Fine-tune how much the reference image influences the output with the strength parameter.
-
Prompt Enhancer Built-in tool to automatically improve your prompts for better results.
-
Ultra-affordable Just $0.01 per image — perfect for high-volume generation and experimentation.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the image you want to generate |
| negative_prompt | No | Elements to avoid in the output |
| image | No | Reference image to guide generation (upload or URL) |
| size | No | Preset size options |
| width | No | Output width in pixels (default: 1024) |
| height | No | Output height in pixels (default: 1024) |
| strength | No | How much the reference image influences output, 0-1 (default: 0.6) |
| seed | No | Random seed for reproducibility (default: -1 for random) |
| output_format | No | Output format: jpeg, png (default: jpeg) |
| enable_sync_mode | No | API only: wait for result before returning response |
Strength Guide (with Reference Image)
- Lower values (0.2-0.4): Strong reference influence, output closely follows the reference image
- Medium values (0.5-0.7): Balanced blend of reference and prompt
- Higher values (0.8-1.0): Prompt dominates, reference serves as loose inspiration
How to Use
Text-to-Image (No Reference)
- Write your prompt — describe the image you want to create.
- Add negative prompt (optional) — specify what to avoid.
- Set dimensions — adjust width and height for your needs.
- Run — submit and download your image.
With Reference Image
- Upload a reference image — to guide the generation's composition or style.
- Write your prompt — describe the desired output.
- Adjust strength — control how much the reference influences the result.
- Run — submit and download your generated image.
Pricing
| Output | Cost |
|---|---|
| Per image | $0.01 |
Best Use Cases
- Rapid Prototyping — Generate multiple concepts quickly at minimal cost.
- Style-guided Generation — Use reference images to maintain consistent aesthetics.
- Content Creation — Produce visuals for social media, blogs, and marketing.
- Creative Exploration — Experiment freely with different prompts and settings.
- Batch Generation — Create large volumes of images affordably.
Pro Tips
- Use the Prompt Enhancer to automatically improve your descriptions.
- For pure text-to-image, be specific about style, lighting, and composition.
- When using a reference image, start with strength around 0.6 and adjust based on results.
- Use negative_prompt to avoid common issues like "blurry, distorted, low quality".
- Keep the same seed to iterate on a specific composition while tweaking the prompt.
- Lower strength values make output follow the reference more closely; higher values give the prompt more creative freedom.
Notes
- When no image is provided, the model runs in pure text-to-image mode.
- The strength parameter only applies when a reference image is provided.
- enable_sync_mode is only available through the API, not in the web interface.
Z Image Base API — Quick start
Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/base with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Z Image Base below.
HTTP example
# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/base" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"negative_prompt": "blurry, low quality, distorted",
"image": "https://example.com/your-input.jpg",
"size": "1024*1024",
"strength": 0.6,
"seed": -1,
"output_format": "jpeg",
"enable_sync_mode": false,
"enable_base64_output": false
}'
# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
-H "Authorization: Bearer $WAVESPEED_API_KEY"
# When status is "completed", read the output from data.outputs[0].Node.js example
// npm install wavespeed
const WaveSpeed = require('wavespeed');
const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env
const result = await client.run("wavespeed-ai/z-image/base", {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"negative_prompt": "blurry, low quality, distorted",
"image": "https://example.com/your-input.jpg",
"size": "1024*1024",
"strength": 0.6,
"seed": -1,
"output_format": "jpeg",
"enable_sync_mode": false,
"enable_base64_output": false
});
console.log(result.outputs[0]); // → URL of the generated outputPython example
# pip install wavespeed
import wavespeed
output = wavespeed.run(
"wavespeed-ai/z-image/base",
{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"negative_prompt": "blurry, low quality, distorted",
"image": "https://example.com/your-input.jpg",
"size": "1024*1024",
"strength": 0.6,
"seed": -1,
"output_format": "jpeg",
"enable_sync_mode": false,
"enable_base64_output": false
}
)
print(output["outputs"][0]) # → URL of the generated outputZ Image Base API — Frequently asked questions
What is the Z Image Base API?
Z Image Base is a WaveSpeedAI model for image generation, exposed as a REST API on WaveSpeedAI. Z-Image-Base is a 6 billion-parameter text-to-image model with full CFG support. Supports negative prompting and fine-tuning capabilities for maximum control over image generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.
How do I call the Z Image Base API?
POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/z-image-base.
How much does Z Image Base cost per run?
Z Image Base starts at $0.010 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.
What inputs does Z Image Base accept?
Key inputs: `prompt`, `image`, `size`, `seed`, `negative_prompt`, `enable_base64_output`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/z-image-base.
How long does Z Image Base take to generate?
Average end-to-end generation time on WaveSpeedAI is around 18 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.
Can I use Z Image Base outputs commercially?
Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.