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:

• - INLINECODE0

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)
• INLINECODE5 (string, optional) e.g. INLINECODE6
• INLINECODE7 (int, optional)
• INLINECODE8 (bool, optional; default false)
• INLINECODE9 (string, optional) override API endpoint

Response

• - image_url (string)
• INLINECODE11 (int)
• INLINECODE12 (int)
• INLINECODE13 (string)
• INLINECODE14 (string, optional)
• INLINECODE15 (string, optional)
• INLINECODE16 (string)

Quick start (curl)

CODEBLOCK0

Local helper script

CODEBLOCK1

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: INLINECODE24
• Override base dir with OUTPUT_DIR.

Validation

CODEBLOCK2

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.
• INLINECODE29 for official docs.