跳到主要内容

单图编辑

更新时间:2026-04-13
单图编辑API能基于用户输入的文字描述和图片,生成符合语义描述的新图片。
POST
https://cloud.baicaiinfer.com/v1/images/generations
Authorizations
AuthorizationsStringHeaderRequired

用户需使用已获取的API Key进行身份验证,以访问服务。

Body
application/json
selected_modelStringRequired

模型名称。更多模型,可参考支持的模型和应用

取值范围:JiMeng-Edit-V30
默认值:-
约束限制:-
task_typeStringRequired

指定生成式模型需执行的任务类型。更多任务类型,可参考支持的模型和应用

取值范围:image-edit
默认值:-
约束限制:-
response_formatString

特定的输出格式。

取值范围:url
默认值:url
约束限制:-
inputObjectRequired

生成式模型的核心参数集合。

input.imageStringRequired

原图资源。

取值范围:-
默认值:-
约束限制:图片要求:格式为PNG或JPG,大小≤4.7MB。
input.promptStringRequired

用于生成图像的提示。

取值范围:1~800
默认值:-
约束限制:支持中英文,建议长度≤120字符,最长不超过800字符,prompt过长有概率出图异常或不生效。
input.resolutionStringRequired

分辨率。

取值范围:1k、2k
默认值:-
约束限制:-
input.aspect_ratioString

指定生成图像的宽高比。

取值范围:1:1、2:3、3:2、3:4、4:3、9:16、16:9、9:21、21:9
默认值:16:9
约束限制:传入的resolution、aspect_ratio值会和既定的值相匹配,如果不符合则直接报错。注意传width,height则不会生效。
input.number_of_imagesInt

指定生成图像的数量。

取值范围:1~4
默认值:1
约束限制:-
need_expand_promptBoolean

是否打开提示词优化。

取值范围:true、false
默认值:false
约束限制:-
asyncBoolean

是否采用异步方式处理请求。

取值范围:true、false
默认值:false
约束限制:-
Response
状态码:application/json
statusIntRequired

表示请求处理状态的状态码。

0是成功标识,表示接口正常返回预期结果。
messageStringRequired

返回请求的处理结果,通常配合状态码使用,直观告知用户当前请求的具体情况。

createdIntRequired

响应的时间戳。

dataobjectRequired

任务的核心结果数据。

data.urlarray[string]Required

是生成图片的网络访问链接(不带水印的),通过该URL可直接下载或在线查看图片文件,适合需要快速预览或通过链接分享的场景。

data.upload_timesarray[number]Required

生成第一张图片时,预处理所花费的时间。

data.time_costnumberRequired

整个请求从接收开始到生成完成所消耗的总时间。

data.url_wmarray[string]Required

是生成图片的网络访问链接(带水印的),通过该URL可直接下载或在线查看图片文件,适合需要快速预览或通过链接分享的场景。

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": "JiMeng-Edit-V30",
    "task_type": "image-edit",
    "input": {
        "image": "https://s1.llamafactory.online/baicai-infer/users/04527f5b186a4b3587863399402cf0d2/KGD3Mz-Baicai_Creation_20260120150937498972.png",
        "prompt": "背景改为海边",
        "resolution": "1k"
    }
}'
{
    "status": 0,
    "message": "success",
    "created": 1770729129,
    "data": {
        "url": [
            "https://s1.llamafactory.online/baicai-infer/results/3485302650917143021/20260306105416583DADE4F984E1E0D582-6963-0_tplv-vu.png"
        ],
        "upload_times": [
            0.8540902994573116
        ],
        "time_cost": 22.731464059092104,
        "url_wm": [
            "https://s1.llamafactory.online/baicai-infer/results/3485302650917143021/jN6j_d-mfzskH-30NQwB9j02wZ61c6litfwr_0wmpZ7MI-iBtvfD5lVCX6-yx2zcGINYVByafQPDdwcqTV4hIA.png"
        ]
    }
}