A lightweight text-to-image model for fast generation, with Chinese and English text rendering, and flexible resolutions.
Try it online: (Singapore | Beijing) | Technical blog
Examples
|
Input prompt |
Output image |
|
Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features four colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza; the third reads “HARAJUKU st” with floating shoes; and the fourth shows a blue mouse riding a skateboard with the text “Takeshita WELCOME.” Dominant bright colors include yellow, teal, orange, pink, and green. Speech bubbles, halftone patterns, and playful characters enhance the urban street-art aesthetic. Daylight evenly illuminates the scene, and the ground beneath her feet is white tiled pavement. Full-body portrait, centered composition, slightly tilted stance, direct eye contact with the camera. High detail, sharp focus, dynamic framing. |
|
Model overview
|
Model Name |
Description |
Output image specifications |
|
z-image-turbo |
A fast lightweight image generation model |
Image resolution: 512×512 to 2048×2048 pixels. See recommended resolutions in size parameter settings. Image format: png Number of images: Fixed at 1. |
Check Model List for region support before calling.
Prerequisites
Create an API key and set the API key as an environment variable.
Synchronous HTTP call
Singapore: POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Request parameters |
Text-to-imageThis example returns an image directly for a faster response. To enable intelligent rewriting, set
|
Request headers |
|
|
Content-Type The content type of the request. Must be |
|
|
Authorization The authentication credentials using a Model Studio API key. Example: |
|
Request body |
|
|
model Model name: z-image-turbo. |
|
|
input Input content. |
|
|
parameters Image generation parameters. |
Response parameters |
Successful task executionTask data (task status and image URLs) is retained for only 24 hours and then automatically purged. Save generated images promptly.
Abnormal task executionOn failure, the system returns error details in `code` and `message` fields. See Error messages for troubleshooting.
|
|
output Model output. |
|
|
usage This includes usage statistics for successful generations only. |
|
|
request_id Unique identifier for the request. Use for tracing and troubleshooting issues. |
|
|
code The error code. Returned only when the request fails. See error codes for details. |
|
|
message Detailed error message. Returned only when the request fails. See error codes for details. |
Limits
-
Image URLs are valid for 24 hours. Download promptly.
Content moderation: The input
promptand output image are both subject to content moderation. Requests containing prohibited content result in anIPInfringementSuspectorDataInspectionFailederror. See error codes for details.
Billing and rate limiting
-
For pricing and free quota, see Model pricing.
-
For rate limits, see Z-Image.
-
Billing is based on successful image count and prompt_extend status. Failed calls do not incur fees or consume free quota.
Error codes
See Error messages for troubleshooting failed calls.
FAQ
Q: How do I view model invocation metrics?
A: One hour after a model invocation completes, go to the Monitoring (Singapore) or Monitoring (China (Beijing)) page to view metrics such as invocation count and success rate. For more information, see Bill query and cost management.
Q: How do I get the domain name whitelist for image storage?
A: Images generated by models are stored in OSS. The API returns a temporary public URL. To configure a firewall whitelist for this download URL, note the following: The underlying storage may change dynamically. This topic does not provide a fixed OSS domain name whitelist to prevent access issues caused by outdated information. If you have security control requirements, contact your account manager to obtain the latest OSS domain name list.
