NXAI 文档

Appearance

文生图 ​

POST  v1/images/generations

官方文档：https://help.aliyun.com/zh/model-studio/z-image-api-reference?spm=a2c4g.11186623.help-menu-2400256.d_2_2_3.5183699dL6MJpu&scm=20140722.H_3002354._.OR_help-T_cn~zh-V_1

请求参数 ​

Authorization ​

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

Header 参数 ​

参数类型必填说明示例
Content-Typestring可选请求体的数据格式类型application/json
Acceptstring可选客户端期望接收的响应数据格式application/json

Body 参数 ​

Content-Type: application/json

参数名类型必填说明
modelstring必需模型名称。指定使用的图像生成模型 ID（例如 doubao-seedream-4-5 等）。
promptstring必需提示词。描述期望生成的图像内容、风格和构图。
parametersobject必需参数
sizestring必需图片尺寸。支持两种格式： 1. 预设代号：如 2K, 3K。 2. 具体分辨率：如 2048x2048（需符合像素总数限制）。
sequential_image_generationstring必需组图生成模式。控制是否开启多图连续生成功能： • disabled：关闭（默认，单次生成一张）。 • auto：自动判断，根据提示词决定生成一组关联图片。
streamboolean必需流式输出。是否以流式方式返回结果（通常用于实时展示生成进度）。
response_formatstring必需响应格式。指定返回数据的格式，通常为 url（图片链接）或 b64_json（Base64编码）。
watermarkboolean必需水印设置。是否在生成的图片上添加平台水印（如“AI生成”标识）。

请求示例 (JSON) ​

{
    "model": "Qwen/Qwen-Image",
    "prompt": "a white siamese cat",
    "n": 1,
    "size": "1024x1024"
}

返回响应 ​

200 成功

Content-Type: application/json

响应参数 ​

字段名类型必填说明
imagesarray [object]必需图片列表。包含生成图片信息的数组。
└─ urlstring可选图片地址。生成图片的直接访问链接。
timingsobject必需耗时统计。记录推理过程的时间消耗信息。
└─ inferencenumber必需推理时间。模型执行生成任务所花费的具体时间（通常以秒为单位）。
seedinteger必需随机种子。用于复现生成结果的种子数值。
shared_idstring必需共享 ID。用于关联同一批次或同一工作流的唯一标识符。
dataarray [object]必需数据列表。包含预测或生成结果的数据数组。
└─ urlstring可选结果地址。相关输出文件的链接。
createdinteger必需创建时间戳。任务创建时的 Unix 时间戳。

响应示例 ​

{
    "images": [
        {
            "url": "https://bizyair-prod.oss-cn-shanghai.aliyuncs.com/outputs%2F7e024863-2d3e-48a5-aa51-2b3ff15991df_66865defbed334c93c160ad2f1f207e5_ComfyUI_83894ea7_00001_.png?OSSAccessKeyId=LTAI5tPza7RAEKed35dCML5U&Expires=1760489302&Signature=8oLTgq6%2BKP%2FQ5cTGY8HAQLLXsr4%3D"
        }
    ],
    "timings": {
        "inference": 0.464
    },
    "seed": 1116635659,
    "shared_id": "0",
    "data": [
        {
            "url": "https://bizyair-prod.oss-cn-shanghai.aliyuncs.com/outputs%2F7e024863-2d3e-48a5-aa51-2b3ff15991df_66865defbed334c93c160ad2f1f207e5_ComfyUI_83894ea7_00001_.png?OSSAccessKeyId=LTAI5tPza7RAEKed35dCML5U&Expires=1760489302&Signature=8oLTgq6%2BKP%2FQ5cTGY8HAQLLXsr4%3D"
        }
    ],
    "created": 1760485702
}

示例代码 ​

python
import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
   "model": "Qwen/Qwen-Image",
   "prompt": "a white siamese cat",
   "n": 1,
   "size": "1024x1024"
})
headers = {
   'Accept': 'application/json',
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/images/generations", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))