Z-Image Turbo 图像生成

阿里巴巴 Z-Image Turbo 高速图像生成模型，追求速度与性价比，擅长高逼真度人像与产品图。

在线体验

在 Playground 中测试 ↗ · 查看模型列表 ↗

快速开始

from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="z-image-turbo",
    prompt="一只可爱的橘猫在窗台上晒太阳",
    size="1024x1536",
    n=1
)

print(response.data[0].url)

请求端点

项目	值
方法	POST
路径	/v1/images/generations
Base URL	https://open.dieyuyun.com
兼容协议	OpenAI Images API

认证

Bearer Token: Authorization: Bearer YOUR_API_KEY

标准请求字段

字段	类型	必填	默认值	说明
model	string	是	—	模型标识: z-image-turbo
prompt	string	是	—	图像描述文本
size	string	否	1024x1536	图像尺寸，总像素范围 [512², 2048²]
n	integer	否	1	生成数量，固定为 1，不支持批量生成
response_format	string	否	url	返回格式: url 或 b64_json

注意事项

• n 固定为 1: Z-Image Turbo 不支持批量生成，每次请求只能生成 1 张图片。
• 不支持 negative_prompt: 该模型不支持负面提示词参数。
• 不支持水印控制: 该模型没有 watermark 参数。

支持的尺寸

尺寸	比例	说明
1024x1024	1:1	方形
1280x1280	1:1	大尺寸方形
1536x1536	1:1	超大方形
1024x1536	2:3	竖版（默认）
1104x1472	3:4	竖版
896x1184	3:4	小尺寸竖版
768x1360	9:16	竖屏
960x1704	9:16	大尺寸竖屏
1152x2048	9:16	超大竖屏
1328x1760	3:4	大尺寸竖版
1704x960	16:9	大尺寸横屏
1760x1328	4:3	大尺寸横版
2048x1152	16:9	超大横屏
1360x768	16:9	横屏
1184x896	4:3	横版
1472x1104	4:3	大尺寸横版

尺寸说明

图像总像素需在 [512², 2048²] 范围内。以上为推荐尺寸，您也可以传入自定义尺寸，只要满足总像素约束即可。

扩展参数

Z-Image Turbo 支持通过 parameters 对象传递扩展参数：

字段	类型	必填	默认值	说明
parameters.prompt_extend	boolean	否	false	是否优化提示词。开启后返回优化后的提示词和思考过程，但会增加费用
parameters.seed	integer	否	—	随机种子，范围 [0, 2147483647]，用于复现生成结果

{
  "model": "z-image-turbo",
  "prompt": "一只可爱的橘猫在窗台上晒太阳",
  "size": "1024x1536",
  "parameters": {
    "prompt_extend": true,
    "seed": 42
  }
}

prompt_extend 说明

与 Qwen Image 不同，Z-Image Turbo 的 prompt_extend 默认为 false。开启后：

• 响应中会返回 revised_prompt（优化后的提示词）和 reasoning_content（思考过程）
• 生成质量可能提升，但会消耗更多 token 和费用

请求示例

cURL

curl https://open.dieyuyun.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "一只可爱的橘猫在窗台上晒太阳",
    "size": "1024x1536",
    "n": 1
  }'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="z-image-turbo",
    prompt="一只可爱的橘猫在窗台上晒太阳",
    size="1024x1536",
    n=1
)

print(response.data[0].url)

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://open.dieyuyun.com/v1',
  apiKey: 'YOUR_API_KEY',
})

const response = await client.images.generate({
  model: 'z-image-turbo',
  prompt: '一只可爱的橘猫在窗台上晒太阳',
  size: '1024x1536',
  n: 1,
})

console.log(response.data[0].url)

开启提示词优化示例

curl https://open.dieyuyun.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "一只可爱的橘猫在窗台上晒太阳",
    "size": "1024x1536",
    "n": 1,
    "parameters": {
      "prompt_extend": true,
      "seed": 42
    }
  }'

响应格式

成功响应（prompt_extend=false）

{
  "created": 1717000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

成功响应（prompt_extend=true）

{
  "created": 1717000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "一只毛色鲜亮的橘猫慵懒地趴在阳光洒满的窗台上，温暖的午后光线透过玻璃窗照在它身上，毛发细节清晰可见，背景是温馨的家居环境",
      "reasoning_content": "用户希望生成一只橘猫在窗台晒太阳的图片。我需要增强这个提示词，添加更多细节描述，包括光线、毛发纹理、环境氛围等，以生成更逼真的图像..."
    }
  ]
}

字段	类型	说明
created	integer	Unix 时间戳
data	array	生成结果数组
data[].url	string	图像 URL
data[].revised_prompt	string	优化后的提示词（仅 prompt_extend=true 时返回）
data[].reasoning_content	string	模型的思考过程（仅 prompt_extend=true 时返回）

错误响应

详见 错误码。

最佳实践

• 速度优先: Z-Image Turbo 以快速生成著称，适合需要大量出图的场景，如电商产品图、社交媒体素材等。
• 人像与产品图: 该模型在高逼真度人像和产品图方面表现优异，适合电商、广告等商业用途。
• 提示词优化: 简单提示词可直接使用默认设置（prompt_extend=false）以节省费用；复杂场景建议开启 prompt_extend 获得更好的生成效果。
• 种子复现: 使用 seed 参数可以复现之前的生成结果，方便在满意的图片基础上进行微调。
• 尺寸选择: 默认尺寸 1024x1536 适合竖版人像；产品图可根据需要选择方形（1024x1024）或横版尺寸。
• 同步返回: 该模型为同步返回，无需轮询 task_id，直接获取结果。

速率限制

详见 速率限制。

相关文档

• 万相 2.7 - 阿里巴巴万相视频生成模型
• 千问图像 - 通义万相图像生成模型
• 模型列表与定价 - 浏览可用模型和定价信息
• 使用 Playground 测试 - 交互式测试图像生成