图像生成同步调用
/api/v1/image/generationHeader Parameters
使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx
Request Body
application/json
模型名称。必须为:z-image-turbo。
"z-image-turbo"输入的基本信息。
请求内容数组。当前仅支持单轮对话,即传入一组role、content参数,不支持多轮对话。
消息的角色。此参数必须设置为user。
消息内容数组。必须包含且仅包含 1 个 text 对象。
正向提示词用于描述期望生成的图像内容、风格和构图。
支持中英文,长度不超过800个字符,每个汉字、字母、数字或符号计为一个字符,超过部分会自动截断。
示例值:一只坐着的橘黄色的猫,表情愉悦,活泼可爱,逼真准确。
注意:仅支持传入一个text,不传或传入多个将报错。
图像处理参数。
输出图像的分辨率,格式为宽*高。
默认值:1024*1536。
总像素范围限制:总像素在 [512512, 20482048]之间。
推荐分辨率范围:总像素在 [10241024, 15361536]之间,出图效果更佳。
示例值:1024*1536。
总像素为1024*1024的推荐分辨率:
1:1: 1024*1024
2:3: 832*1248
3:2: 1248*832
3:4: 864*1152
4:3: 1152*864
7:9: 896*1152
9:7: 1152*896
9:16: 720*1280
9:21: 576*1344
16:9: 1280*720
21:9:1344*576
总像素为1280*1280的推荐分辨率:
1:1: 1280*1280
2:3: 1024*1536
3:2: 1536*1024
3:4: 1104*1472
4:3: 1472*1104
7:9: 1120*1440
9:7: 1440*1120
9:16: 864*1536
9:21: 720*1680
16:9: 1536*864
21:9: 1680*720
总像素为1536*1536的推荐分辨率:
1:1:1536*1536
2:3: 1248*1872
3:2: 1872*1248
3:4: 1296*1728
4:3: 1728*1296
7:9: 1344*1728
9:7: 1728*1344
9:16: 1152*2048
9:21: 864*2016
16:9: 2048*1152
21:9: 2016*864
是否启用智能提示词(text)改写。开启后,将使用大模型优化提示词,并输出思考过程。
false:默认值,关闭智能改写。输出图像和原始文本提示词。
true:开启智能改写。输出图像、优化后的文本提示词、思考过程。
随机数种子,取值范围[0,2147483647]。
使用相同的seed参数值可使生成内容保持相对稳定。若不提供,算法将自动使用随机数种子。
注意:模型生成过程具有概率性,即使使用相同的seed,也不能保证每次生成结果完全一致。
Response Body
application/json
curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \ -H "Authorization: string" \ -H "Content-Type: application/json" \ -d '{ "model": "z-image-turbo", "input": { "messages": [ { "role": "string", "content": [ { "text": "string" } ] } ] }, "parameters": { "size": "string", "prompt_extend": true, "seed": 0 } }'{
"code": 0,
"data": {
"urls": [
"string"
],
"usage": {
"images": 0,
"seconds": 0,
"input_tokens": 0,
"total_tokens": 0,
"output_tokens": 0
},
"expired": "string",
"task_id": "string",
"task_status": "string"
},
"message": "string",
"request_id": "string"
}