POST
/services/aigc/multimodal-generation/generation
cURL
复制
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
"model": "z-image-turbo",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A sitting orange cat with a happy expression, lively and cute, realistic and accurate"
}
]
}
]
},
"parameters": {
"prompt_extend": false,
"size": "1024*1024"
}
}'复制
{
"output": {
"choices": [
{
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
},
{
"text": "Photo of a stylish young woman..."
}
],
"reasoning_content": ""
}
}
]
},
"usage": {
"width": 1024,
"height": 1024,
"image_count": 1,
"input_tokens": 0,
"output_tokens": 0,
"total_tokens": 0
},
"request_id": "abf1645b-b630-433a-92f6-xxxxxx"
}请先获取 API Key 并配置为环境变量。如需使用 SDK,请先安装。
鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
请求体
application/jsonenum<string>
必填
模型名称。
可选值:z-image-turbo
示例:z-image-turbo
object
必填
输入内容。
显示子属性
显示子属性
object[]
必填
请求内容数组。仅支持单轮对话,传入一条 role: user 的消息,不支持多轮。
取值范围:items: 1–1
object
图像生成参数。
显示子属性
显示子属性
string
默认值"1024*1536"
输出图像分辨率,格式为 宽*高。范围:512×512 至 2048×2048 像素,推荐范围:1024×1024 至 1536×1536。默认值:1024*1536。
推荐分辨率(总像素约 1024×1024):1024*1024(1:1)、832*1248(2:3)、1248*832(3:2)、864*1152(3:4)、1152*864(4:3)、720*1280(9:16)、1280*720(16:9)。
推荐分辨率(总像素约 1280×1280):1280*1280(1:1)、1024*1536(2:3)、1536*1024(3:2)、1104*1472(3:4)、1472*1104(4:3)、864*1536(9:16)、1536*864(16:9)。
推荐分辨率(总像素约 1536×1536):1536*1536(1:1)、1248*1872(2:3)、1872*1248(3:2)、1296*1728(3:4)、1728*1296(4:3)、1152*2048(9:16)、2048*1152(16:9)。
示例:1024*1024
boolean
默认值false
开启基于大模型的智能提示词改写。
false(默认):返回图像和原始提示词,不产生额外费用。true:返回图像、优化后的提示词及推理内容,会增加响应时间和费用。
integer
用于控制生成结果可复现性的随机种子。有效范围:[0, 2147483647]。相同种子通常生成相似结果;不填时使用随机种子。
注意: 图像生成具有随机性,即使使用相同种子,结果也可能存在差异。
取值范围:0 <= x <= 2147483647
响应
200-application/json
object
模型输出。
显示子属性
显示子属性
object[]
模型输出内容,数组中包含一个元素。
显示子属性
显示子属性
string
生成结束原因。stop 表示成功。
示例:stop
object
string
请求唯一标识符,可用于追踪和排查问题。
示例:abf1645b-b630-433a-92f6-xxxxxx