fea5e0fac5
- 客户端压缩：保持原格式（JPG保持JPG，PNG保持PNG），不再强制转换为WebP - 提高压缩质量：最低质量从0.6提高到0.90，避免画质损失 - 启用高质量图像平滑：减少锯齿，提升画质 - 服务器端智能优化：使用MozJPEG和PNG优化算法 - 避免双重压缩：小文件(<3MB)跳过服务器端优化，只有优化效果明显(>5%)才使用 - 优化策略：优先缩小尺寸而不是降低质量，留余量给服务器端优化 技术改进： - JPEG: MozJPEG编码器，质量92%，渐进式，优化扫描 - PNG: 压缩级别6，自适应过滤，调色板优化 - 智能判断：避免不必要的双重压缩，保护画质
3.6 KiB
注意事项
接口返回的链接有效期为 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 } }
