AI营销商品图--人像人体-火山引擎

文档中心

导航

AI营销商品图

最近更新时间：2024.12.27 19:05:00首次发布时间：2024.12.18 14:12:58

接口简介

可灵活定制的AIGC商品图片优化服务，能按需调整产品位置、背景环境、光影效果等

请求说明

名称	内容
接口地址	https://visual.volcengineapi.com
请求方式	POST
Content-Type	application/json

完整公共参数列表见公共参数
本服务Region为cn-north-1； Service为cv

Query参数

拼接到url后的参数，示例：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 范围：0_{2（注意：保持在0}1之间最佳）参考图学习程度，越高越接近参考图（仅参考，无法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	上传图片示例：
其它功能（保底功能）
product_safe_switch	可选	bool	产品还原度-安全模式默认：false 开启后，强制还原产品细节。消除产品的任何光影变化。（与环境融合度有所下降）
product_edge_weight	可选	float	产品与环境分离程度默认：0.0 范围：0~1（注意：数值过高时，高概率让产品悬空）如果发现产品边缘有畸形，或有异常粘连时。可以调到0.1~0.2
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	否	明水印自定义内容

输出说明

通用输出参数

请参考通用返回字段及错误码

业务输出参数

重点关注data 字段，其他字段为公共返回

字段	类型	说明
binary_data_base64	array of string	返回图片的base64数组。
image_urls	array of string	输出处理过的图片url 数组（单张图）

请求&返回完整示例

请求示例

{
    "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": "这里是明水印内容"
    }
}

输出示例

{
    "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）通用错误码
请参考通用返回字段及错误码
（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使用说明

人像人体