z-image-turbo 文生图 API 使用文档
基于通义 Z-Image 系列的轻量级文生图模型 z-image-turbo：传入一段中英文提示词即可快速生成图像。模型主打「轻量、快速」，支持中英文文字渲染，并可灵活适配多种分辨率与宽高比（总像素范围 [512×512, 2048×2048]），每次请求固定输出 1 张 PNG 图像。可选的 prompt_extend 智能改写能在出图的同时优化提示词并输出思考过程，进一步提升画面质量。
接口地址
| 接口 | 请求方式 | URL |
|---|---|---|
| 文生图 | POST | https://www.dmxapi.cn/v1/responses |
WARNING
请妥善保管您的 API Key！严禁将密钥泄露给他人、硬编码到代码中或提交到公开的代码仓库。如果怀疑密钥已泄露，请立即前往 DMXAPI 官网重新生成。
模型名称
z-image-turbo
文生图示例代码
python
import requests
import json
# ===============================================================
# 步骤1: 配置 API 连接信息
# ===============================================================
# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"
# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-***********************************************"
# ===============================================================
# 步骤2: 配置请求头
# ===============================================================
headers = {
"Content-Type": "application/json", # 指定请求体为 JSON 格式
"Authorization": f"Bearer {api_key}", # Bearer Token 认证方式 (密钥错误/缺失会返回 401)
}
# ===============================================================
# 步骤3: 配置请求参数
# ===============================================================
payload = {
# 【model】(string, 必填) 调用的模型名称，文生图固定为 z-image-turbo (名称拼写错误会报错)
"model": "z-image-turbo",
# 【input】(object, 必填) 输入的基本信息
"input": {
# 【messages】(array, 必填) 请求内容数组
# 当前仅支持单轮对话：只传入一组 role + content，不支持多轮对话
"messages": [
{
# 【role】(string, 必填) 消息角色，固定为 "user"
"role": "user",
# 【content】(array, 必填) 消息内容数组
# 必须包含且仅包含 1 个 text 对象；不传或传入多个都会报错
"content": [
{
# 【text】(string, 必填) 正向提示词，描述期望生成图像的内容、风格与构图
# - 支持中英文，长度不超过 800 个字符
# （每个汉字 / 字母 / 数字 / 符号均计为 1 个字符，超出部分会被自动截断）
# - 提示词与生成图像均会经过内容安全审核，违规内容将报错
# (DataInspectionFailed / IPInfringementSuspect)
"text": "film grain, analog film texture, soft film lighting, Kodak Portra 400 style, cinematic grainy texture, photorealistic details, subtle noise, (film grain:1.2)。采用近景特写镜头拍摄的东亚年轻女性，呈现户外雪地场景。她体型纤瘦，呈站立姿势，身体微微向右侧倾斜，头部抬起看向画面上方，姿态自然放松。她的面部是典型东亚长相，肤色白皙，脸颊带有自然的红润感，五官清秀：眼睛是深棕色，眼型偏圆，眼神略带惊讶地望向上方，眼白部分可见；眉毛是深黑色，形状自然弯长；鼻子小巧挺直，嘴唇涂有红色口红，唇瓣微张，表情带着轻微的惊讶或好奇。她的头发是深黑色长直发，发丝被风吹得略显凌乱，部分垂在脸颊两侧，头顶佩戴一顶深灰色的头盔，头盔边缘露出少量发丝。服装是蓝白拼接的厚重外套，外套材质看起来是毛绒与布料结合，显得温暖厚实，适合雪地环境。背景是被白雪覆盖的户外场景，远处可见模糊的树木轮廓，天空是明亮的浅蓝色，带有少量白云，光线是强烈的自然日光，照亮人物面部与头发，形成清晰的光影，色调以蓝、白、黑为主，整体风格清新自然。画面顶部有黑色提示框，内有“Press esc to exit full screen”的白色文字。镜头的近景视角放大了人物的表情与细节，营造出户外雪地的真实氛围。"
}
]
}
]
},
# 【parameters】(object, 可选) 图像生成参数
"parameters": {
# 【prompt_extend】(bool, 可选) 是否启用智能提示词改写，默认 False
# - False: 关闭智能改写，按原始提示词出图，仅返回图像与原始提示词，响应更快
# - True : 开启智能改写，由大模型优化提示词并输出思考过程
# 出图质量通常更好，但响应更慢、开销更高（会产生额外 token）
# 开启后响应会额外返回「改写后的提示词」与「思考过程」，
# 且 usage.output_tokens_details.reasoning_tokens > 0
# - 说明: 按官方计费 True 单价高于 False；实际计费以 DMXAPI 平台为准
"prompt_extend": False,
# 【size】(string, 可选) 输出图像分辨率，格式为 "宽*高"（英文星号），默认 "1024*1536"
# - 总像素范围: [512*512, 2048*2048]，超出此范围会报错 InvalidParameter
# - 推荐范围 : 总像素在 [1024*1024, 1536*1536] 之间出图效果更佳
# - size 不限于下表取值，任意 "宽*高" 只要总像素落在 [512*512, 2048*2048] 即可，下表仅为画质推荐
# - 各宽高比推荐分辨率（按总像素分为三组）:
# 宽高比 │ 1024*1024 组 │ 1280*1280 组 │ 1536*1536 组
# ───────┼──────────────┼──────────────┼──────────────
# 1:1 │ 1024*1024 │ 1280*1280 │ 1536*1536
# 2:3 │ 832*1248 │ 1024*1536 │ 1248*1872
# 3:2 │ 1248*832 │ 1536*1024 │ 1872*1248
# 3:4 │ 864*1152 │ 1104*1472 │ 1296*1728
# 4:3 │ 1152*864 │ 1472*1104 │ 1728*1296
# 7:9 │ 896*1152 │ 1120*1440 │ 1344*1728
# 9:7 │ 1152*896 │ 1440*1120 │ 1728*1344
# 9:16 │ 720*1280 │ 864*1536 │ 1152*2048
# 9:21 │ 576*1344 │ 720*1680 │ 864*2016
# 16:9 │ 1280*720 │ 1536*864 │ 2048*1152
# 21:9 │ 1344*576 │ 1680*720 │ 2016*864
"size": "1120*1440",
# 【seed】(integer, 可选) 随机数种子，取值范围 [0, 2147483647]
# 使用相同 seed 可使生成结果相对稳定；不传则自动使用随机种子
# 注意: 生成过程具有概率性，相同 seed 也不保证结果完全一致
"seed": 42,
},
}
# ===============================================================
# 步骤4: 发送请求并输出结果
# ===============================================================
# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)
# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))返回示例
json
{
"output": [
{
"type": "message",
"content": [
{
"type": "image",
"text": "https://dashscope-a717.oss-cn-beijing.aliyuncs.com/7d/21/20260625/448165f2/3d071ed2-acf0-9640-9b17-56f6285a86562091883678.png?Expires=1782962396&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=tbBAgAS32cbB%2F2MaiV8pTdCJBnc%3D"
}
]
}
],
"request_id": "3d071ed2-acf0-9640-9b17-56f6285a8656",
"usage": {
"total_tokens": 1000,
"input_tokens": 0,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 1000,
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}© 2026 DMXAPI z-image-turbo 文生图