## 接口简介可灵活定制的AIGC商品图片优化服务，能按需调整产品位置、背景环境、光影效果等 ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |**Content\-Type** |**application/json** | ### **Header参数** 完整公共参数列表见 [公共参数](https://www.volcengine.com/docs/6369/67268) 本服务**Region为**cn\-north\-1； **Service为**cv ### **Query参数** > 拼接到url后的参数，示例：[https://visual.volcengineapi.com](https://visual.volcengineapi.com/)**?Action=CVProcess&Version=2022\-08\-31** |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，取固定值：**CVProcess** | |Version |必选 |String |版本号，取固定值：**2022\-08\-31** | ### **Body参数** > 业务请求参数，放到request.body中，MIME\-Type为**application/json** |参数 |可选/必选 |类型 |说明 |备注 | |---|---|---|---|---| |输入图片、遮罩类型 ||||| |req_key |必选 |String |算法名称，取**固定值为img2img_e_commerce_style** | | |product_image_input |必选 |String |产品图URL，可输入任意图片格式，支持透明底PNG | | |ref_image_input |可选 |String |参考图URL，可输入参考图 | | |product_alpha_switch |可选 |bool |自动识别透明通道，开启后优先使用输入图的透明通道，未识别到透明图层时，自动使用火山侧自动抠主体功能| |\ | | | |默认：true | | |mask_image_switch |可选 |bool |手动上传mask功能开关，上传mask后需要手动开启，默认为自动抠产品图+识别产品图的透明通道| |\ | | | |默认：false | | |mask_image_input |可选 |String |遮罩蒙版图片| |\ | | | |可输入黑白mask遮罩图，功能需要启"mask_image_switch":true | | |mask_invert_switch |可选 |bool |遮罩图片反转，默认开启，反转输入遮罩图| |\ | | | |默认：true | | |seg_prompt |可选 |String |自动扣图\-指定物体| |\ | | | |默认就会自动抠出主体，一般无需输入。图片内有多个不同的物体时，必要时可通过提示抠出需要的物体 | | |【构图三选一】原图构图（默认，无需额外输入） ||||| |longer_side |可选 |int |输出分辨率| |\ | | | |默认：1600| |\ | | | |按**产品输入图**的长边缩放分辨率，保持原图比例，（推荐输入能被8整除的数，例如：768，1024，1280，1440，1600，2000···）仅影响输出分辨率，不影响生图过程 | | |【构图三选一】自动构图 ||||| |auto_composition_switch |可选 |bool |自动构图| |\ | | | |默认：false 【默认将产品置中】 | | |canvas_width |可选 |int |画布宽度（像素）| |\ | | | |默认：1000 | | |canvas_height |可选 |int |画布高度（像素）| |\ | | | |默认：1000 | | |auto_offset_x |可选 |int |x轴偏移（百分比）| |\ | | | |默认：50 | | |auto_offset_y |可选 |int |y轴偏移（百分比）| |\ | | | |默认：50 | | |auto_scale |可选 |float |scale大小（百分比）| |\ | | | |默认：0.7 | | |【构图三选一】手动构图 ||||| |manual_composition_switch |可选 |bool |手动构图| |\ | | | |默认：false | | |canvas_width |可选 |int |画布宽度（像素）| |\ | | | |默认：1000 （仅影响输出分辨率，不影响生图过程） | | |canvas_height |可选 |int |画布高度（像素）| |\ | | | |默认：1000 （仅影响输出分辨率，不影响生图过程） | | |offset_x |可选 |int |x轴偏移（像素）| |\ | | | |默认：0 | | |offset_y |可选 |int |y轴偏移（像素）| |\ | | | |默认：0 | | |crop_prodcut_switch |可选 |bool |自动裁切至商品大小| |\ | | | |默认：true (手动构图开启时，该字段才生效可选）| |\ | | | |true：裁剪至商品大小| |\ | | | |false：保持输入图片大小 | | |生图参数 ||||| |product_weight |可选 |float |产品还原强度| |\ | | | |默认：0.85| |\ | | | |范围：0~1.3 （注意：超过1.3会报错）| |\ | | | |默认已开启光影变化，产品还原程度。越低越容易受氛围、环境的光影影响 | | |ref_switch |可选 |bool |参考图功能开关| |\ | | | |默认：false | | |ref_weight |可选 |float |参考图强度| |\ | | | |默认：0.75| |\ | | | |范围：02（注意：保持在01之间最佳）| |\ | | | |参考图学习程度，越高越接近参考图（仅参考，无法100%还原参考图） | | |ref_end_at |可选 |float |参考图引导结束时间| |\ | | | |默认：0.75| |\ | | | |范围：0~1| |\ | | | |参考图引导的结束时间，1=完整引导，0.5=生成到50%时结束引导，让模型自由发挥，获得更好的细节 | | |seed |可选 |int |随机种子| |\ | | | |默认：\-1（随机） | | |positive_prompt |可选 |String |积极提示词| |\ | | | |默认："table,room,warm tone," | | |控制光源（可选） ||||| |preset_light_switch |可选 |bool |预设光源开关| |\ | | | |默认关：false | | |light_position |可选 |String |预设光源类型| |\ | | | |左光源："Left Light"| |\ | | | |右光源："Right Light"| |\ | | | |顶光源："Top Light"| |\ | | | |底光源："Bottom Light"| |\ | | | |左上光源："Top Left Light" 【开启预设光后默认】| |\ | | | |右上光源："Top Right Light"| |\ | | | |左下光源："Bottom Left Light"| |\ | | | |右下光源："Bottom Right Light" | | |upload_light_switch |可选 |bool |手动上传光源开关| |\ | | | |默认关：false | | |light_image_input |可选 |String |手动上传光源图片URL |上传图片示例：|\ | | | | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d8aa3c5b6e7245fc887092bf379cac3d~tplv-goo7wpa0wc-image.image =136x) | |其它功能（保底功能） ||||| |product_safe_switch |可选 |bool |产品还原度\-安全模式| |\ | | | |默认：false| |\ | | | |开启后，强制还原产品细节。消除产品的任何光影变化。（与环境融合度有所下降） | | |product_edge_weight |可选 |float |产品与环境分离程度| |\ | | | |默认：0.0| |\ | | | |范围：0~1（注意：数值过高时，高概率让产品悬空）| |\ | | | |如果发现产品边缘有畸形，或有异常粘连时。可以调到0.04~0.1 | | |return_url |可选 |bool |输出是否返回图片链接 **（链接有效期为24小时）** | | |logo_info |可选 |LogoInfo |水印信息 | | **LogoInfo** 水印相关参数 |名称 |类型 |必选 |描述 |备注 | |---|---|---|---|---| |add_logo |Boolean |否 |是否添加水印。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) ### **业务输出参数** 重点关注data 字段，其他字段为公共返回 |字段 |类型 |说明 | |---|---|---| |binary_data_base64 |array of string |返回图片的base64数组。 | |image_urls |array of string |输出处理过的图片url|\ | | |数组（单张图） | ## 请求&返回完整示例 ### **请求示例** ```json { "req_key": "img2img_e_commerce_style", "product_image_input": "https://xxx", "ref_image_input": "https://xxx", "product_alpha_switch": true, "mask_invert_switch": true, "auto_composition_switch": false, "canvas_width": 1000, "canvas_height": 1000, "auto_offset_x": 50, "auto_offset_y": 50, "auto_scale": 0.7, "product_weight": 0.85, "ref_switch": false, "ref_weight": 0.75, "ref_end_at": 0.75, "seed": -1, "positive_prompt": "table,room,warm tone,", "preset_light_switch": false, "light_position": "Top Light", "upload_light_switch": false, "product_safe_switch": false, "product_edge_weight": 0, "return_url": true, "logo_info": { "add_logo": false, "position": 0, "language": 0, "opacity": 1, "logo_text_content": "这里是明水印内容" } } ``` ### **输出示例** ```json { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "comfyui_cost": 10, "image_output": [ "uri://binary_data?index=0" ], "image_urls": [ "https://xxx" ] }, "message": "Success", "request_id": "202412172023408C2FE3E4A836ECAFC7CE", "status": 10000, "time_elapsed": "11.60766912s" } ``` ## 错误码 **（1）通用错误码** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) **（2）业务错误码** |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)

人像人体