请求信息 / 返回信息 / 示例代码

图像变高清API

一、请求信息

请求URL：https://api.shiliuai.com/api/super_resolution/v1

请求方式：POST

请求参数-请求头（Header）：

参数	类型	说明
Content-Type	string	application/json
APIKEY	string	您的API KEY

请求参数-请求内容（Body）：

参数	类型	说明
image_base64	string, required	base64编码的图片文件，图片可以是单通道，三通道或四通道，图片文件要小于20M，图片的长边不能超过4096像素
scale_factor	int, optional	放大倍数，可取值1，2，3，4，默认为1，放大倍数和图片长边乘积不能超过4096像素，如果超过，会自动降低放大倍数

二、返回信息

参数	说明
code	错误码
msg	错误信息（英文）
msg_cn	错误信息（中文）
result_base64	高清图片的base64编码，（当code==0时会有该返回值），如果输入图片是四通道，那么返回四通道png格式图片，否则返回jpg格式图片，返回图片通道数和输入图片相同

错误码说明：

错误码	说明
0	成功
1	图片错误
2	处理错误
3	服务器繁忙
4	参数错误，具体错误看msg或msg_cn
5	未知错误
101	API-KEY不正确
102	未知用户
103	积分已用完
104	扣除积分失败

三、示例代码

Python 代码示例：

import requests
import base64
import cv2
import json
import numpy as np


api_key = '******'  # 你的API KEY
file_path = '...'  # 图片路径

with open(file_path, 'rb') as fp:
    photo_base64 = base64.b64encode(fp.read()).decode('utf8')

url = 'https://api.shiliuai.com/api/super_resolution/v1'
headers = {'APIKEY': api_key, "Content-Type": "application/json"}
data = {
    "base64": photo_base64,
    "scale_factor": 2  # 放大2倍
    }

response = requests.post(url=url, headers=headers, json=data)
response = json.loads(response.content)
"""
成功：{'code': 0, 'msg': 'OK', 'msg_cn': '成功', 'result_base64': result_base64}
or
失败：{'code': error_code, 'msg': error_msg, 'msg_cn': 错误信息}
"""
result_base64 = response['result_base64']
file_bytes = base64.b64decode(result_base64)
f = open('result.jpg', 'wb')
f.write(file_bytes)
f.close()

image = np.asarray(bytearray(file_bytes), dtype=np.uint8)
image = cv2.imdecode(image, cv2.IMREAD_UNCHANGED)
cv2.imshow('result', image)
cv2.waitKey(0)

PHP 代码示例：

$url = "https://api.shiliuai.com/api/super_resolution/v1";
$method = "POST";
$apikey = "******";
$header = array();
array_push($header, "APIKEY:" . $apikey);
array_push($header, "Content-Type:application/json");

$file_path = "...";
$handle = fopen($file_path, "r");
$photo = fread($handle, filesize($file_path));
fclose($handle);
$photo_base64 = base64_encode($photo);

$data = array(
  "base64"=> $photo_base64,
  "scale_factor"=> 2
);
$post_data = json_encode($data);

$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);

$response = curl_exec($curl);
var_dump($response);