HomeBrowseUpload
← Back to registry
// Skill profile

Model Studio Z-Image Turbo

name: alicloud-ai-image-zimage-turbo

by cinience · published 2026-03-22

图像生成API集成
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:cinience/cinience-alicloud-ai-image-zimage-turbo
View on GitHub
// Full documentation

---

name: alicloud-ai-image-zimage-turbo

description: Generate 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.

version: 1.0.0

---

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

    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.
  • // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band