最近更新时间:2024.03.13 15:49:09
首次发布时间:2023.06.05 17:21:13
传入老照片图片,返回经颜色增强和去除照片模糊度之后的图片。目前默认开启审核。
名称 | 内容 |
---|---|
图片要求 | 1. 图片格式:JPG、JPEG、PNG、BMP等常见格式,建议使用JPG格式。 |
名称 | 内容 |
---|---|
接口地址 | https://visual.volcengineapi.com |
请求方式 | POST |
Content-Type | application/json |
请求参数
(1)header请求参数
以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256:签名方法 |
X-Security-Token | String | 否 | 指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。 |
(2)Query参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:ConvertPhotoV2 |
Version | 必选 | String | 版本号,取值:2022-08-31 |
(3)Body参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
req_key | 必选 | String | 算法名称,取固定值为"lens_opr" |
binary_data_base64 | 必选(二选一,优先生效) | array of string | 输入图片的base64数组。此算法需要输入x张图片,第一张为xxx,第二张为xxx |
image_urls | 必选(二选一) | array of string | 输入图片URL数组。此算法需要输入x张图片,第一张为xxx,第二张为xxx |
if_color | 可选 | int | 0:不上色(不走色彩增强);1:强制上色;2:自动色彩判断,黑白走上色逻辑,彩色走色彩增强。默认为 1 |
(1)通用输出参数
请参考通用返回字段及错误码
(2)业务输出参数
data 字段说明
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
binary_data_base64 | array of string | 返回图片的base64数组。此算法会返回x张图片,第一张为xxx,第二张为xxx |
(3)输出示例
{ "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "success" }, "binary_data_base64": [] }, "message": "Success", "request_id": "202307181529599405FC6AD01BD7D8B76A", "status": 10000, "time_elapsed": "2.259797743s" }
(1)通用错误码
请参考通用返回字段及错误码
(2)业务错误码
HttpCode | 错误码 | 错误消息 | 描述 |
---|---|---|---|
200 | 10000 | 无 | 请求成功 |
400 | 60701 | "Convert Photo Error" | 老照片服务错误信息 |
400 | 60702 | "Invalid Input Image: get convert photo input image error" | 图像解析错误 |