fea5e0fac5
- 客户端压缩：保持原格式（JPG保持JPG，PNG保持PNG），不再强制转换为WebP - 提高压缩质量：最低质量从0.6提高到0.90，避免画质损失 - 启用高质量图像平滑：减少锯齿，提升画质 - 服务器端智能优化：使用MozJPEG和PNG优化算法 - 避免双重压缩：小文件(<3MB)跳过服务器端优化，只有优化效果明显(>5%)才使用 - 优化策略：优先缩小尺寸而不是降低质量，留余量给服务器端优化 技术改进： - JPEG: MozJPEG编码器，质量92%，渐进式，优化扫描 - PNG: 压缩级别6，自适应过滤，调色板优化 - 智能判断：避免不必要的双重压缩，保护画质
158 lines
3.6 KiB
Markdown
158 lines
3.6 KiB
Markdown
注意事项
|
||
|
||
接口返回的链接有效期为 1 小时，请及时下载存储。
|
||
图片格式要求
|
||
|
||
格式 分辨率 大小
|
||
jpg, jpeg, bmp, png, webp, tiff, tif, bitmap, raw, rgb, jfif, lzw 最大 4096x4096 最大20MB
|
||
快速开始
|
||
|
||
异步
|
||
不同调用方式的区别&优缺点？
|
||
Image URL
|
||
Image File
|
||
cURL
|
||
PHP
|
||
Java
|
||
NodeJs
|
||
Python
|
||
C#
|
||
Swift
|
||
Go
|
||
#Create a task.
|
||
curl -k 'https://techsz.aoscdn.com/api/tasks/visual/scale' \
|
||
-H 'X-API-KEY: YOUR_API_KEY' \
|
||
-F 'sync=0' \
|
||
-F 'image_url=YOU_IMG_URL'
|
||
|
||
#Get the cutout result
|
||
#Polling requests using the following methods 1. The polling interval is set to 1 second, 2. The polling time does not exceed 30 seconds
|
||
curl -k 'https://techsz.aoscdn.com/api/tasks/visual/scale/{task_id}' \
|
||
-H 'X-API-KEY: YOUR_API_KEY' \
|
||
在线调试
|
||
|
||
|
||
POST
|
||
/api/tasks/visual/scale
|
||
创建图片变清晰任务
|
||
创建图片变清晰任务
|
||
|
||
图片大小: 不超过 20 MB
|
||
图片来源：文件上传（二进制）或从 URL 下载
|
||
消耗：每次成功调用，最长边≤2048px则消耗2算粒，2048px<最长边≤4096px则消耗3算粒。
|
||
|
||
Parameters
|
||
Name Description
|
||
X-API-KEY *
|
||
string
|
||
(header)
|
||
API Key
|
||
|
||
Request body
|
||
|
||
image_file
|
||
string($binary)
|
||
源图像文件（二进制）。（如果此参数存在，则其他图像源参数必须为空）
|
||
|
||
Send empty value
|
||
image_url
|
||
string
|
||
源图像URL。(如果存在此参数，则其他图像源参数必须为空)
|
||
|
||
Send empty value
|
||
sync
|
||
integer
|
||
是否等待结果就绪并立即返回（默认值：0）。如果设为1，API将会等待结果准备好后立即返回。如果设为0，API将返回 task_id，稍后可通过 /{task_id} 端点获取结果。请注意，请求提交后，结果最多只会保留1个小时。
|
||
|
||
Send empty value
|
||
type
|
||
string
|
||
修复类型：
|
||
"clean" = 通用放大清晰化。
|
||
"face" = 人像放大清晰化。(1张图片中，最多仅能同时变清晰10个人)
|
||
|
||
Send empty value
|
||
scale_factor
|
||
integer
|
||
放大倍数：
|
||
空 = 自动缩放。(10,512]，放大4倍；(512,1024]，放大2倍；(1024,4096]，保持原大小。
|
||
1 = 不放大。(长边范围需要在区间[10,4096]内)
|
||
2 = 2倍放大。(长边范围需要在区间[10,1024]内)
|
||
4 = 4倍放大。(长边范围需要在区间[10,512]内)
|
||
|
||
Send empty value
|
||
return_type
|
||
integer
|
||
1 = 返回图片的下载URL。
|
||
2 = 以base64字符串形式返回图片。
|
||
3 = 以二进制流的形式返回图片（当前只支持同步接口）。
|
||
|
||
Send empty value
|
||
Execute
|
||
Responses
|
||
Code Description
|
||
200
|
||
任务创建成功。
|
||
Media type
|
||
|
||
Controls Accept header.
|
||
Example Value
|
||
Schema
|
||
{
|
||
"status": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"task_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||
}
|
||
}
|
||
400
|
||
客户端参数传递错误。 请检查参数是否缺失或值是否正确
|
||
401
|
||
认证失败。 请检查X-API-KEY是否正确或者服务是否开通
|
||
429
|
||
请求频率超出QPS限制（默认QPS为2）。请放缓请求速率，或者联系商务提升QPS限制
|
||
更多详见状态码说明
|
||
|
||
GET
|
||
/api/tasks/visual/scale/{task_id}
|
||
获取图片变清晰结果
|
||
获取图片变清晰结果。
|
||
|
||
Url中的参数 task_id 由创建图片变清晰任务后返回。
|
||
|
||
Parameters
|
||
Name Description
|
||
X-API-KEY *
|
||
string
|
||
(header)
|
||
API Key
|
||
|
||
task_id *
|
||
string
|
||
(path)
|
||
图片变清晰任务的ID
|
||
|
||
Execute
|
||
Responses
|
||
Code Description
|
||
200
|
||
请求成功
|
||
Media type
|
||
|
||
Controls Accept header.
|
||
Example Value
|
||
Schema
|
||
{
|
||
"status": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"created_at": "1634884056",
|
||
"processed_at": "1634884056",
|
||
"completed_at": "1634884056",
|
||
"image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/93a5e47b-a9c1-47ac-9b5e-22cb89f7d358-image.jpg",
|
||
"task_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
|
||
"progress": 100,
|
||
"state": 1
|
||
}
|
||
}
|