alicloud-ai-image-zimage-turbo
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)
```bash
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
```bash
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 `512*512` and `2048*2048`.
- Prefer common sizes like `1024*1024`, `1280*720`, `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
```bash
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
1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
2) Run one minimal read-only query first to verify connectivity and permissions.
3) Execute the target operation with explicit parameters and bounded scope.
4) 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.
标签
skill
ai
