典名词元典名词元首页
API 文档三方工具教程
AI 模型接口图像Z-Image

图像生成同步调用

POST/api/v1/image/generation

Header Parameters

Authorization?string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称。必须为:z-image-turbo。

Value in"z-image-turbo"
input*object

输入的基本信息。

messages*array<object>

请求内容数组。当前仅支持单轮对话,即传入一组role、content参数,不支持多轮对话。

[]?object
role*string

消息的角色。此参数必须设置为user。

content*array<object>

消息内容数组。必须包含且仅包含 1 个 text 对象。

[]?object
text*string

正向提示词用于描述期望生成的图像内容、风格和构图。

支持中英文,长度不超过800个字符,每个汉字、字母、数字或符号计为一个字符,超过部分会自动截断。

示例值:一只坐着的橘黄色的猫,表情愉悦,活泼可爱,逼真准确。

注意:仅支持传入一个text,不传或传入多个将报错。

parameters?object

图像处理参数。

size?string

输出图像的分辨率,格式为宽*高。

默认值: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

prompt_extend?boolean

是否启用智能提示词(text)改写。开启后,将使用大模型优化提示词,并输出思考过程。

false:默认值,关闭智能改写。输出图像和原始文本提示词。

true:开启智能改写。输出图像、优化后的文本提示词、思考过程。

seed?integer

随机数种子,取值范围[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"
}