## 接口简介对输入的单张图进行综合的智能画质增强，低清图像高清化，高清图像超清化。方案包含画质分析，超分，去模糊等功能，可以智能根据输入画质选择最佳的增强幅度，提升画面清晰度与主观质量。 ## 限制条件 |名称 |内容 | |---|---| |图片要求 |1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。|\ | |2. 图片大小及分辨率：最大 5 MB; 输入图片尺寸 width 满足 [50, 2128], height 满足 [50, 4046]。 | ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[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 |接口名，取值：EnhancePhotoV2 | |Version |必选 |String |版本号，取值：2022\-08\-31 | ### **Body参数** > 业务请求参数，放到request.body中，MIME\-Type为**application/json** |参数 |可选/必选 |类型 |取值范围 |默认值 |说明 | |---|---|---|---|---|---| |req_key |必选 |string | |"lens_lqir" |算法名称，取固定值为lens_lqir | |binary_data_base64 |必选（二选一，优先生效） |array of string | |[""] |图片文件，base64编码列表。此算法需要输入1张图片 | |image_urls |必选（二选一） |array of string | |[""] |图片文件URL | |resolution_boundary |可选 |string |"144p": [192, 144]|"720p" |图片分辨率 < resolution_boundary：内部算法走超分流程，结果图分辨率x2|\ | | | |"240p": [320, 240]| |图片分辨率 \>= resolution_boundary: 内部算法走去模糊流程，结果图分辨率不变 |\ | | | |"360p": [480, 360]| | |\ | | | |"480p": [640, 480]| | |\ | | | |"540p": [960, 540]| | |\ | | | |"720p": [1280, 720]| | |\ | | | |"1080p": [1920, 1080]| | |\ | | | |"2k": [2048, 1152] | | | |enable_hdr |可选 |boolean | |false |是否开启hdr能力 | |enable_wb |可选 |boolean | |false |是否开启白平衡能力 | |result_format |可选 |int |0,1 |0 |0 代表结果图片为png格式|\ | | | | | |1 代表结果图片为jpeg格式 | |jpg_quality |可选 |int |[0, 100] |95 |值越高，代表生成jpg图片的质量越高 | |hdr_strength |可选 |float |(0.0, 1.0] |1.0 |值越高，代表HDR效果越明显 | |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数组（单张图） | ## 请求&返回完整示例 ### **请求示例** ```Java { "req_key": "lens_lqir", "image_urls": [ "https://xxx" ], "resolution_boundary": "540p", "enable_hdr": False, "enable_wb": False, "result_format": 1, "jpg_quality": 95, "hdr_strength": 1.0, "return_url": True, "logo_info": { "add_logo": False, "position": 0, "language": 0, "opacity": 0.3, "logo_text_content": "这里是明水印内容" } } ``` ### **输出示例** ```json { "code":10000, "data":{ "algorithm_base_resp":{ "status_code":0, "status_message":"success" }, "binary_data_base64":[ "xxxxxx" ], "image_urls": [ "https://xxx" ] }, "message":"Success", "request_id":"20220927104718010211219136065E4C28", "status":10000, "time_elapsed":"3.599807005s" } ``` ## 错误码 **（1）通用错误码** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) **（2）业务错误码** |HttpCode |错误码 |错误消息 |描述 | |---|---|---|---| |200 |10000 |无 |请求成功 | ## SDK使用说明请参考[SDK使用说明](https://www.volcengine.com/docs/6444/1340578)

图像技术