## 接口简介图生图能力，可以保持输出图片的人脸特征与输入「形象图」一致，输出图片风格支持通过「输入图」的风格、「风格图」的风格或文本prompt进行调节。 ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |Content\-Type |application/json | ## 限制条件 |名称 |内容 | |---|---| |图片要求 |1. 图片格式：JPG(JPEG), PNG, BMP 等常见格式, 建议使用JPG格式.|\ | | 最小 128 x 128 像素，最大 4096 x 4096 像素；|\ | |2. base64格式下单张图片最大4.7Mb，2张图最大不超过8Mb. | ### **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_anime_accelerated_maintain_id_for_smart_drawing_anime | | |binary_data_base64 |可选 |array of String |如果需要传图，与image_urls二选一传入 | | |image_urls |可选 |array of String |如果需要传图，与binary_data_base64二选一传入 | | |positive_prompt |可选 |String |积极提示词，一般建议预置构图提示词和风格提示词（有特殊要求可联系火山引擎对接同学），同时接收终端用户写入的内容拼接好后传入。| |\ | | | |默认值：++best_quality,anime_style,++ | | |hyper_switch |可选 | |加速hyper，文生图加速专用（需要关闭face_switch、facestyle_switch、style_switch），开启后step与cfg失效| |\ | | | |默认值：false | | |seed |可选 |int |随机种子，\-1为不随机种子；其他为指定随机种子| |\ | | | |默认值：\-1 | | |step |可选 |int |默认值：18 | | |cfg |可选 |float |默认值：6.0 | | |face_image |可选 |string |输入形象图|未传时|\ | | | |格式："uri://binary_data?index=0" （index对应输入图binary_data_base64/image_urls的下标） |需要关闭face_switch、facestyle_switch、style_switch | |face_detection_switch |可选 |bool |脸部识别开关| |\ | | | |关闭后火山侧不再进行形象图的脸部识别，适合关闭的场景：APP端已经进行裁切，直接上传| |\ | | | |默认值：true | | |style_image |可选 |string |输入风格图|未传时|\ | | | |格式："uri://binary_data?index=1" （index对应输入图binary_data_base64/image_urls的下标） |需要关闭style_switch | |face_switch |可选 |bool |形象图人脸学习开关，打开则学习形象图的人脸特征| |\ | | | |默认值：false | | |face_v2_switch |可选 |bool |形象图人脸学习开关v2| |\ | | | |与形象图人脸学习开关相比，有以下优化：| |\ | | | || |\ | | | |1. 脸型、眼神相似度+10~20%| |\ | | | |2. 分离出反推字段开关face_tagger_switch，可以选择关闭| |\ | | | || |\ | | | |默认值：false | | |facestyle_switch |可选 |bool |形象图风格学习开关，打开则学习形象图的风格，会参考姿势、发色、画风，但提示词听话程度\-50%。facestyle_switch与style_switch强烈建议二选一，否则效果互有干扰且延迟长。| |\ | | | |默认值：false | | |style_switch |可选 |bool |风格图的风格学习开关，打开则学习风格图的风格。风格图强烈不建议传入真人图片，可传入动漫人物或风格化明显的图片。| |\ | | | |默认值：false | | |face_tagger_switch |可选 |bool |反推提示词| |\ | | | |建议配合 face_v2_switch 一同开启。关闭后，只学习脸型特征。输入提示词更加听话| |\ | | | |默认值：false | | |width |可选 |int |生成图像的宽| |\ | | | |默认值：1000| |\ | | | |取值范围[600\-1500] | | |height |可选 |int |生成图像的高| |\ | | | |默认值：1000| |\ | | | |取值范围[600\-1500] | | |clarity |可选 |float |清晰度| |\ | | | |默认0.6，取值范围【0\-1】 | | |return_url |可选 |bool |如果为true，则输出参数不再返回binary_data_base64，而是图片的url **（链接有效期为24小时）** | | |logo_info |可选 |LogoInfo |水印信息 | | |pose_switch |可选 |bool |姿势控制开关| |\ | | | |关闭后，姿势会随机生成，可能会出现大头照、出框等情况。存在竖构图，希望半身等需求时，建议开启。| |\ | | | |默认值：false | | |pose_y |可选 |float |姿势控制（y轴高度）| |\ | | | |默认值：85（百分比） | | |pose_scale |可选 |float |姿势控制（缩放大小）| |\ | | | |默认值：1.8 （倍率） | | **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_anime_accelerated_maintain_id_for_smart_drawing_anime", "positive_prompt": "1girl,beautiful,looking at viewer,portrait,", "return_url": True, "image_urls": [ "https://xxx"], # "binary_data_base64": [], "hyper_switch": True, "seed": -1, "step": 18, "cfg": 4.5, "face_image": "uri://binary_data?index=0", "style_image": "uri://binary_data?index=1", "face_switch": True, "facestyle_switch": True, # "style_switch": False, "width": 1000, "height": 1000, "logo_info": { "add_logo": True, "position": 2, "language": 0, "opacity": 0.3, "logo_text_content": "这里是明水印内容" } } ``` ### **输出示例** ```json { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": ["xxx"], "image_urls": [""], "request_id": "" }, "message": "Success", "request_id": "2024061214082851989A35E4283DB7C8AD", "status": 10000, "time_elapsed": "16.52978614s" } ``` ## 错误码 **（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)

图像技术