图片编辑
图片编辑API能基于用户输入的文字描述和图片,生成符合语义描述的新图片。
POST
https://cloud.baicaiinfer.com/v1/images/generations
Authorizations
Body
application/json
response_format:String
特定的输出格式。
取值范围:
url、b64_json默认值:url
约束限制:-
inference_tier:String
本次任务的调用模式,不同模式对应不同的计费标准。
取值范围:
FASTEST(极速)、STANDARD(标准)、ECONOMICAL(经济)默认值:FASTEST
约束限制:-
input:ObjectRequired
生成式模型的核心参数集合。
input.image:StringRequired
原图资源。
取值范围:
-默认值:-
约束限制:图片要求:格式为PNG或JPG,大小≤10MB。
input.prompt:StringRequired
用于生成图像的正向提示词。
取值范围:
1~800默认值:-
约束限制:支持中英文,超出字符限制部分会自动截断。
input.negative_prompt:String
用于指定生成图像时需避免的元素(如低质量、失真等)的反向提示词。
取值范围:
1~500默认值:-
约束限制:支持中英文,超出字符限制部分会自动截断。
input.width:IntRequired
指定生成图像的宽度,单位像素,用于定义输出图像在水平方向上的尺寸。
取值范围:
1~5404默认值:-
约束限制:-
input.height:IntRequired
指定生成图像的高度,单位像素,用于定义输出图像在垂直方向上的尺寸。
取值范围:
1~5404默认值:-
约束限制:若提供的 width 和 height 的具体像素值,不满足16倍数,系统会相应自动调整。
input.number_of_images:Int
指定生成图像的数量。
取值范围:
1~4默认值:1
约束限制:-
input.num_inference_steps:Int
指定生成模型迭代优化的次数,次数越多生成图像细节越精细、质量越高,但同时会增加生成耗时。
取值范围:
1~50默认值:28
约束限制:-
input.true_cfg_scale:Float
调节模型在生成时遵循文本提示词的程度,数值越大生成内容与提示词越一致,但可能降低多样性或导致过饱和。
取值范围:
1~20默认值:9.0
约束限制:-
input.strength:Float
控制生成图像对原始输入图像的保留程度,值越高则对原图的改变越大,反之越接近原图。
取值范围:
0~1默认值:0.75
约束限制:-
input.seed:Int
生成式模型中控制结果随机性的种子,固定它可复现相同结果,改变则生成不同内容。
取值范围:
-1~4294967295默认值:-1
约束限制:-
need_expand_prompt:Boolean
是否打开提示词优化。
取值范围:
true、false默认值:false
约束限制:-
async:Boolean
是否采用异步方式处理请求。
取值范围:
true、false默认值:false
约束限制:-
Response
状态码:application/json
200
status:IntRequired
表示请求处理状态的状态码。
0
400
500
0是成功标识,表示接口正常返回预期结果。
message:StringRequired
返回请求的处理结果,通常配合状态码使用,直观告知用户当前请求的具体情况。
created:IntRequired
响应的时间戳。
data:objectRequired
任务的核心结果数据。
data.url:array[string]Required
是生成图片的网络访问链接(不带水印的),通过该URL可直接下载或在线查看图片文件,适合需要快速预览或通过链接分享的场景。
data.upload_times:array[number]Required
生成第一张图片时,预处理所花费的时间。
data.time_cost:numberRequired
整个请求从接收开始到生成完成所消耗的总时间。
data.url_wm:array[string]Required
是生成图片的网络访问链接(带水印的),通过该URL可直接下载或在线查看图片文件,适合需要快速预览或通过链接分享的场景。
cURL
Python
JavaScript
curl --location --request POST 'https://cloud.baicaiinfer.com/v1/images/generations' \
--header 'Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****' \
--header 'Content-Type: application/json' \
--data-raw '{
"selected_model": "Qwen-Image-Edit",
"task_type": "image-edit",
"input": {
"image": "https://s1.llamafactory.online/baicai-infer/users/acb6f5bdf6a04e53820a62b9ea53152c/307b7736f009461c9e0a0e3710d82dbe.png",
"prompt": "Change the hair to straight bangs",
"width": 1024,
"height": 1024
}
}'
200
400
401
404
500
{
"status": 0,
"message": "success",
"created": 1770626716,
"data": {
"url": [
"https://s1.llamafactory.online/baicai-infer/results/b31829f224fb44759b9fa019ca63bc7f/321d6700f99a43b08a5fcabc3cebef48.png"
],
"upload_times": [
0.32969123777002096
],
"time_cost": 40.09935710020363,
"url_wm": [
"https://s1.llamafactory.online/baicai-infer/results/b31829f224fb44759b9fa019ca63bc7f/U4IoEcGreRg0a3Lka41BnJl_xZB2__hn9-vHnZiTOSuYxnuOdiS700GjPYMIxQSx.png"
]
}
}