Category: provider
Model Studio Z-Image Turbo
Use Z-Image Turbo for fast text-to-image generation via the DashScope multimodal-generation API.
Critical model name
Use ONLY this exact model string:
- z-image-turbo
Prerequisites
-
Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials (env takes precedence).
-
Choose region endpoint (Beijing or Singapore). If unsure, pick the most reasonable region or ask the user.
Normalized interface (image.generate)
Request
-
prompt (string, required)
-
size (string, optional) e.g. 1024*1024
-
seed (int, optional)
-
prompt_extend (bool, optional; default false)
-
base_url (string, optional) override API endpoint
Response
-
image_url (string)
-
width (int)
-
height (int)
-
prompt (string)
-
rewritten_prompt (string, optional)
-
reasoning (string, optional)
-
request_id (string)
Quick start (curl)
curl -sS 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation'
-H 'Content-Type: application/json'
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
-d '{
"model": "z-image-turbo",
"input": {
"messages": [
{
"role": "user",
"content": [{"text": "A calm lake at dawn, a lone angler casting a line, cinematic lighting"}]
}
]
},
"parameters": {
"size": "1024*1024",
"prompt_extend": false
}
}'
Local helper script
python skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/generate_image.py
--request '{"prompt":"a fishing scene at dawn, cinematic, realistic","size":"1024*1024"}'
--output output/ai-image-zimage-turbo/images/fishing.png
--print-response
Size notes
-
Total pixels must be between 512512 and 20482048 .
-
Prefer common sizes like 10241024 , 1280720 , 1536*864 .
Cost note
- prompt_extend=true is billed higher than false . Only enable when you need rewritten prompts.
Output location
-
Default output: output/ai-image-zimage-turbo/images/
-
Override base dir with OUTPUT_DIR .
Validation
mkdir -p output/alicloud-ai-image-zimage-turbo for f in skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/alicloud-ai-image-zimage-turbo/validate.txt
Pass criteria: command exits 0 and output/alicloud-ai-image-zimage-turbo/validate.txt is generated.
Output And Evidence
-
Save artifacts, command outputs, and API response summaries under output/alicloud-ai-image-zimage-turbo/ .
-
Include key parameters (region/resource id/time range) in evidence files for reproducibility.
Workflow
-
Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
-
Run one minimal read-only query first to verify connectivity and permissions.
-
Execute the target operation with explicit parameters and bounded scope.
-
Verify results and save output/evidence files.
References
-
references/api_reference.md for request/response schema and regional endpoints.
-
references/sources.md for official docs.