aliyun-zimage-turbo

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Use when generating images with Alibaba Cloud Model Studio Z-Image Turbo (z-image-turbo) via DashScope multimodal-generation API. Use when creating text-to-image outputs, controlling size/seed/prompt_extend, or documenting request/response mapping for Z-Image.

2installs
Sourcecinience/alicloud-skills
Added on

NPX Install

npx skill4agent add cinience/alicloud-skills aliyun-zimage-turbo

Tags

Translated version includes tags in frontmatter
text-to-imagez-image-turbodashscope-apialibaba-cloudimage-generation

SKILL.md Content

View Translation Comparison →
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/aliyun-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/aliyun-zimage-turbo
for f in skills/ai/image/aliyun-zimage-turbo/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-zimage-turbo/validate.txt
Pass criteria: command exits 0 and 
output/aliyun-zimage-turbo/validate.txt
is generated.

Output And Evidence

  • Save artifacts, command outputs, and API response summaries under 
    output/aliyun-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.