通用1.4-角色特征保持,基于通用1.4底模,包含主体外观保持和面部特征保持。其中主体外观信息包含人/动物/物体等各类主体。主体外观和面部特征,两者在生图过程中跟输入文本共同起作用,生成外观跟输入参考图中的主体一致又符合文本描述的图片。
名称 | 内容 |
---|---|
图片要求 |
|
名称 | 内容 |
---|---|
接口地址 | |
请求方式 | POST |
Content-Type | application/json |
完整公共参数列表见 公共参数
本服务Region为cn-north-1; Service为cv
拼接到url后的参数,示例:https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取固定值:CVProcess |
Version | 必选 | String | 版本号,取固定值:2022-08-31 |
业务请求参数,放到request.body中,MIME-Type为application/json
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
req_key | 必选 | String | 算法名称,取固定值为high_aes_general_v14_ip_keep |
binary_data_base64 | 必选(二选一,优先生效) | array of string | 图片文件,base64编码。此算法需输入1张图片 |
image_urls | 必选(二选一) | array of string | 图片文件URL。此算法需输入1张图片 |
prompt | 必选 | String | 用于生成图像的提示词 ,中英文均可输入 |
model_version | 必选 | String | 模型版本名称,固定值:general_v1.4_ip |
ref_ip_weight | 可选 | float | 参考图主体外观的权重,越大生成结果和参考图中主体的相似度越高 |
ref_id_weight | 可选 | float | 参考图人脸特征的权重,越大生成结果和参考图中人脸的相似度越高 |
seed | 可选 | int | 随机种子,-1为不随机种子;其他为指定随机种子 |
scale | 可选 | float | 影响文本描述的程度 |
ddim_steps | 可选 | int | 生成图像的步数 |
width | 可选 | int | 生成图像的宽(超分前大小) |
height | 可选 | int | 生成图像的高(超分前大小) |
use_rephraser | 可选 | bool | 开启中文prompt扩写 |
use_predict_tags | 可选 | bool | 开启predict_tags |
use_sr | 可选 | bool | True:文生图+AIGC超分 |
return_url | 可选 | bool | 输出是否返回图片链接 |
logo_info | 可选 | LogoInfo | 水印信息 |
LogoInfo
水印相关参数
名称 | 类型 | 必选 | 描述 | 备注 |
---|---|---|---|---|
add_logo | Boolean | 否 | 是否添加水印。True为添加,False不添加。默认不添加 | |
position | Int | 否 | 水印的位置,取值如下: | |
language | Int | 否 | 水印的语言,取值如下: | |
logo_text_content | String | 否 | 明水印自定义内容 |
请参考通用返回字段及错误码
重点关注data 字段,其他字段为公共返回
字段 | 类型 | 说明 |
---|---|---|
binary_data_base64 | array of string | 返回图片的base64数组。 |
image_urls | array of string | 输出处理过的图片url |
{ "req_key": "high_aes_general_v14_ip_keep", // "binary_data_base64": [], "image_urls": ["https://xxx"], "prompt": "千军万马", "model_version": "general_v1.4_ip", "subject_prompt": "", "ref_ip_weight": 0.7, "ref_id_weight": 0.9, "negative_prompt": "negative prompt:nsfw, nude, blurry, watermark, identifying mark, low resolution, mutated, lack of hierarchy", "seed": -1, "scale": 3.0, "ddim_steps": 16, "width": 512, "height": 512, "use_rephraser": false, "use_predict_tags": true, "use_sr": true, "sr_seed": -1, "sr_strength": 0.4, "sr_scale": 3.5, "sr_steps": 10, "return_url": true, "logo_info": { "add_logo": false, "position": 0, "language": 0, "logo_text_content": "这里是明水印内容" } }
{ "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "image_urls": [ "https://xxx" ], "predict_tags_result": "xxx", "rephraser_result": "xxx", "request_id": "xxxxx9ccce338c963032f7a3ec06f03d259f1c46215750eca3b7f51f5f97xxxx" }, "message": "Success", "request_id": "2024101217550004248C63C19B1F15xxxx", "status": 10000, "time_elapsed": "9.867352102s" }
(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使用说明