Which model name and credentials are required?

Requests must use the exact model string `z-image-turbo`. Authentication comes from `DASHSCOPE_API_KEY` or `dashscope_api_key` in `~/.alibabacloud/credentials`, with the environment variable taking precedence.

Which image sizes can I request?

Total pixel count must fall between `512*512` and `2048*2048`. Suggested common sizes include `1024*1024`, `1280*720`, and `1536*864`.

What does prompt extension change?

`prompt_extend` defaults to false. When enabled, the response may include a rewritten prompt, but the document notes that it is billed at a higher rate.

Design & media

Alibaba Cloud AI Image Zimage Turbo

Generate images with `z-image-turbo` through DashScope and save image files with response metadata.

What it does

Generate text-to-image output with Alibaba Cloud Model Studio’s `z-image-turbo` through the DashScope multimodal-generation API. Supply a prompt plus optional size, seed, prompt extension, and endpoint override; receive an image URL, dimensions, prompt metadata, and request ID. A local helper can save generated images and response evidence under the configured output directory.

When to use it

Generating a square image from a text prompt
Creating 16:9 scene artwork
Producing repeatable output with a fixed seed
Testing Beijing or Singapore API endpoints

The skill document

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 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

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.

Questions people ask

Which model name and credentials are required?: Requests must use the exact model string `z-image-turbo`. Authentication comes from `DASHSCOPE_API_KEY` or `dashscope_api_key` in `~/.alibabacloud/credentials`, with the environment variable taking precedence.
Which image sizes can I request?: Total pixel count must fall between `512*512` and `2048*2048`. Suggested common sizes include `1024*1024`, `1280*720`, and `1536*864`.
What does prompt extension change?: `prompt_extend` defaults to false. When enabled, the response may include a rewritten prompt, but the document notes that it is billed at a higher rate.