## 接口简介主体保持可自动识别并分割用户输入图片的主体，并通过提示词指令方式控制图片换背景，生成主体在新场景的图片。 ## 限制条件 |名称 |内容 | |---|---| |输入图要求 |1. 图片格式：JPG(JPEG), PNG, BMP 等常见格式, 建议使用JPG格式。 |\ | |2. 小于5 MB，小于4096 x 4096。 | ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |**Content\-Type** |**application/json** | ### **Header参数** :::warning 本服务固定值：**Region为cn\-north\-1，Service为cv** ::: 主要用于鉴权，详见 [公共参数](https://www.volcengine.com/docs/6369/67268) \- 签名参数 \- 在Header中的场景部分 ### **Query参数** :::tip 拼接到url后的参数，示例：[https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31](https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31) ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，取固定值：**CVProcess** | |Version |必选 |String |版本号，取固定值：**2022\-08\-31** | ### **Body参数** :::warning 业务请求参数，放到request.body中，MIME\-Type为**application/json** ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |req_key |必选 |String |算法名称，取**固定值为img2img_bgpaint_light** | |binary_data_base64 |必选（二选一） |array of string |图片文件，base64编码。 | |image_urls |必选（二选一） |array of string |图片文件URL。 | |prompt |可选 |String |换背景，用于描述生成图的场景内容 | |seed |可选 |int |随机种子，作为确定扩散初始状态的基础，默认\-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致|\ | | | |默认值：\-1 | |blend |可选 |float |控制前景保留程度，数值越小，前景变化越大|\ | | | |默认值：0.5|\ | | | |取值范围：[0, 1] | |num_steps |可选 |int |推理步数|\ | | | |默认值：25|\ | | | |取值范围：[10, 40] | |post_process |可选 |String |是否启用对应的后处理，可选取值：|\ | | | ||\ | | | |* "SR"：超分处理|\ | | | |* "HDR"：提亮处理 | |return_url |可选 |bool |输出是否返回图片链接 **（链接有效期为24小时）** | |logo_info |可选 |LogoInfo |水印信息 | **LogoInfo** 水印相关参数 |名称 |类型 |必选 |描述 | |---|---|---|---| |add_logo |bool |否 |是否添加水印。True为添加，False不添加。默认不添加 | |position |Int |否 |水印的位置，取值如下：|\ | | | |0\-右下角|\ | | | |1\-左下角|\ | | | |2\-左上角|\ | | | |3\-右上角|\ | | | |默认0 | |language |Int |否 |水印的语言，取值如下：|\ | | | |0\-中文（AI生成）|\ | | | |1\-英文（Generated by AI）|\ | | | |默认0 | |opacity |Float |否 |水印的不透明度，取值范围0\-1，1表示完全不透明，默认0.3 | |logo_text_content |String |否 |明水印自定义内容 | ## 输出说明 ### **通用输出参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ### **业务输出参数** :::tip 重点关注data 字段，其他字段为公共返回 ::: |字段 |类型 |说明 | |---|---|---| |binary_data_base64 |array of string |返回图片的base64数组。 | |image_urls |array of string |输出处理过的图片url数组（单张图） | ## 请求&返回完整示例 ### **请求示例** ```json { "req_key": "img2img_bgpaint_light", // "binary_data_base64": [], "image_urls": [ "https://xxx", ], "seed": -1, "blend": 0.5, "prompt": "", "num_steps": 25, "return_url": true, "logo_info": { "add_logo": false, "position": 0, "language": 0, "logo_text_content": "这里是明水印内容" } } ``` ### **输出示例** ```json { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "image_urls": [ "https://xxxx" ], "request_id": "d3b3a8795f7e794ab3c1a7a2ca968bed8671faeed039c9b0f1ad864fb88cfad1" }, "message": "Success", "request_id": "2025030619041261665580B7794D1D0D0C", "status": 10000, "time_elapsed": "8.784697603s" } ``` ## 错误码 ### **通用错误码** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ### **业务错误码** |HttpCode |错误码 |错误消息 |描述 | |---|---|---|---| |200 |10000 |无 |请求成功 | |400 |50411 |Pre Img Risk Not Pass |输入图片前审核未通过 | |400 |50511 |Post Img Risk Not Pass |输出图片后审核未通过 | |400 |50412 |Text Risk Not Pass |输入文本前审核未通过 | |400 |50512 |Post Text Risk Not Pass |输出文本后审核未通过 | |400 |50413 |Post Text Risk Not Pass |输入文本NER、IP、Blocklist等拦截 | ## 接入说明 ### SDK使用说明请参考[SDK使用说明](https://www.volcengine.com/docs/6444/1340578) ### HTTP方式接入说明请参考[HTTP请求示例](https://www.volcengine.com/docs/6444/1390583)

人像人体