{"skill":{"slug":"alicloud-ai-image-zimage-turbo","displayName":"Alicloud Ai Image Zimage Turbo","summary":"Generate images with Alibaba Cloud Model Studio Z-Image Turbo (z-image-turbo) via DashScope multimodal-generation API. Use when creating text-to-image output...","description":"---\nname: alicloud-ai-image-zimage-turbo\ndescription: 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.\nversion: 1.0.0\n---\n\nCategory: provider\n\n# Model Studio Z-Image Turbo\n\nUse Z-Image Turbo for fast text-to-image generation via the DashScope multimodal-generation API.\n\n## Critical model name\n\nUse ONLY this exact model string:\n- `z-image-turbo`\n\n## Prerequisites\n\n- Set `DASHSCOPE_API_KEY` in your environment, or add `dashscope_api_key` to `~/.alibabacloud/credentials` (env takes precedence).\n- Choose region endpoint (Beijing or Singapore). If unsure, pick the most reasonable region or ask the user.\n\n## Normalized interface (image.generate)\n\n### Request\n- `prompt` (string, required)\n- `size` (string, optional) e.g. `1024*1024`\n- `seed` (int, optional)\n- `prompt_extend` (bool, optional; default false)\n- `base_url` (string, optional) override API endpoint\n\n### Response\n- `image_url` (string)\n- `width` (int)\n- `height` (int)\n- `prompt` (string)\n- `rewritten_prompt` (string, optional)\n- `reasoning` (string, optional)\n- `request_id` (string)\n\n## Quick start (curl)\n\n```bash\ncurl -sS 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \\\n  -H 'Content-Type: application/json' \\\n  -H \"Authorization: Bearer $DASHSCOPE_API_KEY\" \\\n  -d '{\n    \"model\": \"z-image-turbo\",\n    \"input\": {\n      \"messages\": [\n        {\n          \"role\": \"user\",\n          \"content\": [{\"text\": \"A calm lake at dawn, a lone angler casting a line, cinematic lighting\"}]\n        }\n      ]\n    },\n    \"parameters\": {\n      \"size\": \"1024*1024\",\n      \"prompt_extend\": false\n    }\n  }'\n```\n\n## Local helper script\n\n```bash\npython skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/generate_image.py \\\n  --request '{\"prompt\":\"a fishing scene at dawn, cinematic, realistic\",\"size\":\"1024*1024\"}' \\\n  --output output/ai-image-zimage-turbo/images/fishing.png \\\n  --print-response\n```\n\n## Size notes\n\n- Total pixels must be between `512*512` and `2048*2048`.\n- Prefer common sizes like `1024*1024`, `1280*720`, `1536*864`.\n\n## Cost note\n\n- `prompt_extend=true` is billed higher than `false`. Only enable when you need rewritten prompts.\n\n## Output location\n\n- Default output: `output/ai-image-zimage-turbo/images/`\n- Override base dir with `OUTPUT_DIR`.\n\n## Validation\n\n```bash\nmkdir -p output/alicloud-ai-image-zimage-turbo\nfor f in skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/*.py; do\n  python3 -m py_compile \"$f\"\ndone\necho \"py_compile_ok\" > output/alicloud-ai-image-zimage-turbo/validate.txt\n```\n\nPass criteria: command exits 0 and `output/alicloud-ai-image-zimage-turbo/validate.txt` is generated.\n\n## Output And Evidence\n\n- Save artifacts, command outputs, and API response summaries under `output/alicloud-ai-image-zimage-turbo/`.\n- Include key parameters (region/resource id/time range) in evidence files for reproducibility.\n\n## Workflow\n\n1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.\n2) Run one minimal read-only query first to verify connectivity and permissions.\n3) Execute the target operation with explicit parameters and bounded scope.\n4) Verify results and save output/evidence files.\n\n## References\n\n- `references/api_reference.md` for request/response schema and regional endpoints.\n- `references/sources.md` for official docs.\n","tags":{"latest":"1.0.3"},"stats":{"comments":0,"downloads":1637,"installsAllTime":4,"installsCurrent":4,"stars":0,"versions":4},"createdAt":1770768216406,"updatedAt":1778486994957},"latestVersion":{"version":"1.0.3","createdAt":1773221853133,"changelog":"batch publish from alicloud-skills on 2026-03-11","license":"MIT-0"},"metadata":null,"owner":{"handle":"cinience","userId":"s1707avh05gnzr3g6e3m9ka6fh840rtd","displayName":"cinience","image":"https://avatars.githubusercontent.com/u/557426?v=4"},"moderation":null}