单图生图
单图生图API能基于用户输入的文字描述和图片,生成符合语义描述的新图片。
POST
https://cloud.baicaiinfer.com/v1/images/generations
Authorizations
Body
application/json
response_format:String
允许强制模型产生特定的输出格式,默认值:url。
input:ObjectRequired
生成式模型的核心参数集合。
input.image:StringRequired
【单图生图】输入的原图资源(支持png、jpg格式)。
input.prompt:StringRequired
是生成图像时用于描述期望内容(如场景、风格、细节等)的正向提示词,指导模型生成符合需求的图像。
input.resolution:StringRequired
分辨率(取值:1k、2k)。
input.aspect_ratio:String
指定生成图像的宽高比(取值:1:1、2:3、3:2、3:4、4:3、9:16、16:9、21:9),默认16:9。传入的resolution 、aspect_ratio值会和既定的值相匹配,如果不符合则直接报错。注意传width, height则不会生效。
input.number_of_images:Int
指定生成图像的数量,取值范围为1~4。默认值: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-5p1zwaivq2bRCfF08Vm*****' \
--header 'Content-Type: application/json' \
--data-raw '{
"selected_model": "Kling-o1-I2I",
"task_type": "img2img",
"input": {
"image": "https://s1.llamafactory.online/baicai-infer/users/04527f5b186a4b3587863399402cf0d2/KGD3Mz-Baicai_Creation_20260120150937498972.png",
"prompt": "头发改为齐刘海",
"resolution": "1k"
}
}'
200
400
401
404
500
{
"status": 0,
"message": "success",
"created": 1770728799,
"data": {
"url": [
"https://s1.llamafactory.online/baicai-infer/results/73d4acee7b4f419d86635942e7666c45/na9_fS8apvtlmfuKHZnmRqG1ln0wf-CrDmGE7f3fQ9HW0njK_.png"
],
"upload_times": [
0.9894343400374055
],
"time_cost": 34.67865599412471,
"url_wm": [
"https://s1.llamafactory.online/baicai-infer/results/73d4acee7b4f419d86635942e7666c45/FCvApDpNZ_DBpqqJiKqIhhBaPor2V4c-2MR_ORUXQgcHTXqSIi1-6G3PBEdOryeFypRi4g-i26izQjhkqC_0jw.png"
]
}
}