跳到主要内容

图片编辑

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

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

Body
application/json
selected_modelStringRequired

模型名称,取值:Qwen-Image-Edit。更多模型,可参考支持的模型和应用

task_typeStringRequired

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

response_formatString

允许强制模型产生特定的输出格式,默认值:url。

inference_tierString

本次任务的调用模式,不同模式对应不同的计费标准。取值:FASTEST(极速)、STANDARD(标准)、ECONOMICAL(经济),默认值:FASTEST。

inputObjectRequired

生成式模型(如图像生成)的核心参数集合。

input.imageStringRequired

原图资源(支持png、jpg格式)。

input.promptStringRequired

是生成图像时用于描述期望内容(如场景、风格、细节等)的正向提示词,指导模型生成符合需求的图像。

input.negative_promptString

用于指定生成图像时需避免的元素(如低质量、失真等)的反向提示词,以优化生成结果的质量。

input.widthIntRequired

指定生成图像的宽度,单位通常为像素,用于定义输出图像在水平方向上的尺寸,取值:1~5404。

input.heightIntRequired

指定生成图像的高度,单位通常为像素,用于定义输出图像在垂直方向上的尺寸,取值:1~5404。若提供的 width 和 height 的具体像素值,不满足16倍数,系统会相应自动调整。

input.number_of_imagesInt

指定生成图像的数量,取值范围为1~4。默认值:1。

input.num_inference_stepsInt

指定生成模型迭代优化的次数,次数越多生成图像细节越精细、质量越高,但同时会增加生成耗时,取值:1~50,默认值:28。

input.true_cfg_scaleFloat

调节模型在生成时遵循文本提示词的程度,数值越大生成内容与提示词越一致,但可能降低多样性或导致过饱和,取值:0~20,默认值:9.0。

input.strengthFloat

控制生成图像对原始输入图像的保留程度,值越高则对原图的改变越大,反之越接近原图,取值:0~1,默认值:0.75。

input.seedInt

生成式模型中控制结果随机性的种子,固定它可复现相同结果,改变则生成不同内容,取值:-1~4294967295,默认值:-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-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
    }
}'
{
    "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"
        ]
    }
}