alicloud-ai-image-zimage-turbo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Category: provider

分类：服务商

Model Studio Z-Image Turbo

Use Z-Image Turbo for fast text-to-image generation via the DashScope multimodal-generation API.

通过DashScope多模态生成API，使用Z-Image Turbo快速生成文本转图片内容。

Critical model name

关键模型名称

Use ONLY this exact model string:

```
z-image-turbo
```

请严格使用以下精确的模型字符串：

```
z-image-turbo
```

Prerequisites

前置条件

Set

DASHSCOPE_API_KEY

in your environment, or add

dashscope_api_key

~/.alibabacloud/credentials

(env takes precedence).

Choose region endpoint (Beijing or Singapore). If unsure, pick the most reasonable region or ask the user.

在环境变量中设置
```
DASHSCOPE_API_KEY
```
，或在
```
~/.alibabacloud/credentials
```
中添加
```
dashscope_api_key
```
（环境变量优先级更高）。
选择区域端点（北京或新加坡）。若不确定，请选择最合理的区域或询问用户。

Normalized interface (image.generate)

标准化接口（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

```
prompt
```
（字符串，必填）
```
size
```
（字符串，可选）例如
```
1024*1024
```
```
seed
```
（整数，可选）
```
prompt_extend
```
（布尔值，可选；默认值为false）
```
base_url
```
（字符串，可选）用于覆盖API端点

Response

响应参数

```
image_url
```
(string)
```
width
```
(int)
```
height
```
(int)
```
prompt
```
(string)
```
rewritten_prompt
```
(string, optional)
```
reasoning
```
(string, optional)
```
request_id
```
(string)

```
image_url
```
（字符串）
```
width
```
（整数）
```
height
```
（整数）
```
prompt
```
（字符串）
```
rewritten_prompt
```
（字符串，可选）
```
reasoning
```
（字符串，可选）
```
request_id
```
（字符串）

Quick start (curl)

快速开始（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
    }
  }'

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

bash

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

总像素数必须在
```
512*512
```
到
```
2048*2048
```
之间。
优先选择常见尺寸，如
```
1024*1024
```
、
```
1280*720
```
、
```
1536*864
```
。

Cost note

费用说明

```
prompt_extend=true
```
is billed higher than
```
false
```
. Only enable when you need rewritten prompts.

```
prompt_extend=true
```
的计费高于
```
false
```
。仅在需要重写提示词时启用该选项。

Output location

输出位置

Default output:
```
output/ai-image-zimage-turbo/images/
```
Override base dir with
```
OUTPUT_DIR
```
.

默认输出目录：
```
output/ai-image-zimage-turbo/images/
```
可通过
```
OUTPUT_DIR
```
覆盖基础目录。

References

参考资料

```
references/api_reference.md
```
for request/response schema and regional endpoints.
```
references/sources.md
```
for official docs.

```
references/api_reference.md
```
：包含请求/响应 schema 及区域端点信息。
```
references/sources.md
```
：官方文档来源。