蒸汽机 Air-Image
更新时间：2025-12-02
POST
https://qianfan.baidubce.com/v2/musesteamer/images/generations
调用本接口，使用图像生成模型百度蒸汽机Air-Image（MuseSteamer-Air-Image)生成图片。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看 认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
用于生图的模型。当前支持musesteamer-air-image。
必选
prompt
string
所需生成图片的描述。最大为 1000 个字符。
必选
size
string
只支持以下可选值，输入非可选值时，自动处理为1024*1024。
默认值为1024x1024。
可选值为：
- 1024x1024
- 1280x720
- 720x1280
- 1152x️864
- 864x1152
- 1328x1328
- 1664x928
- 928x1664
- 1472x1104
- 1104x1472
可选
seed
integer
随机种子。不设置时，自动生成随机数。取值范围为[0, 4294967295]
可选
prompt_extend
string
控制是否开启 prompt 增强。默认为true，开启。
可选
response_format
string
生成图像返回的格式。默认值为url，可填入url、b64_json。当填入b64_json返回图像的base64编码。
可选
请求结构
POST /v2/musesteamer/images/generations HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model":"musesteamer-air-image",
"prompt":"画一个西瓜",
"size":"1024x1024",
"seed":42949672,
"prompt_extend":true,
"response_format":"url"
}示例代码
请求示例
curl https://qianfan.baidubce.com/v2/musesteamer/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
"model":"musesteamer-air-image",
"prompt":"画一个西瓜",
"size":"1024x1024",
"seed":42949672,
"prompt_extend":true,
"response_format":"url"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
本次请求的唯一标识，可用于排查问题。
必选
created
integer
时间戳。
必选
data
object {2}
响应列表。
可选
显示子属性
隐藏子属性
url
string
图片链接，有效期24h。
可选
b64_json
string
图像的base64编码。
可选
JSON
{
"id": "as-****g9ydp",
"created": 1764665123,
"data": [
{
"url": "http://****/musesteamer-air-image/***/img-e4541c45-68ff-486c-7ab9-e5157708874c.jpeg"
}
]
}JSON
{
"error": {
"code": "invalid_argument",
"message": "seed is invalid",
"type": "invalid_request_error"
},
"id": "as-****9fsv"
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。