You need to enable JavaScript to run this app.
导航
调用方式V3(公测)
最近更新时间:2024.12.11 15:31:39首次发布时间:2024.10.14 11:52:22

接口简介

对输入图像进行 x2 超分,有效提升低分辨率图像的质量,大幅改善图像纹理细节、抑制压缩伪像,全面提高图像清晰度与主观质量。

限制条件

名称

内容

图片要求

  1. 图片格式:JPG、JPEG、PNG、BMP等常见格式,建议使用JPG格式。
  2. 图片大小及尺寸:最大 5 MB,宽必须在[256, 1024]范围内, 长必须在[256, 1024]范围内。

请求说明

名称

内容

接口地址

https://visual.volcengineapi.com

请求方式

POST

Content-Type

application/json

Header参数

完整公共参数列表见 公共参数
本服务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

算法名称,取固定值为lens_nnsr2_pic_common

binary_data_base64

必选(二选一,优先生效)

array of String

输入图片的base64数组,仅支持一张图

image_urls

必选
(与binary_data_base64二选一)

array of String

输入图片的url数组,仅支持一张图

model_quality

必选

String

选取哪种模型进行超分,LQ适用于低质量图片,HQ适用于高质量图片。
推荐值: "MQ"
取值范围:["HQ", "MQ", "LQ" ],

result_format

int

输出图片的文件格式
0 代表结果图片为png格式,1 代表结果图片为jpeg格式
默认值:0
取值范围:[0, 1]

jpg_quality

可选

int

值越高代表生成jpg图片的质量越高
默认值:95
取值范围:[0, 100]

return_url

可选

bool

输出是否返回图片链接 (链接有效期为1小时)

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": "lens_nnsr2_pic_common",
    // "binary_data_base64": [],
    "image_urls": ["https://xxx"],
    "model_quality": "MQ",
    "result_format": 0,
    "jpg_quality": 95,
    "return_url": True,
    "logo_info": {
        "add_logo": True,        
        "position": 2,           
        "language": 0,
        "opacity": 0.3,           
        "logo_text_content": "这里是明水印内容"
    }
}

输出示例

{
    "code": 10000,
    "data": {
        "algorithm_base_resp": {
            "status_code": 0,
            "status_message": "success"
        },
        "binary_data_base64": [],
        "image_urls": [
            "https://xxx"
        ]
    },
    "message": "Success",
    "request_id": "2024101020203635A3A1848DC372F9XXXX",
    "status": 10000,
    "time_elapsed": "6.251813359s"
}

错误码

(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使用说明