任务:图片清晰化(无损放大)
简洁描述:使用图片清晰化接口对图像进行无损放大和增强处理。
概览
- 请求方法:
POST - 路径:
/task/pic/scale - 内容类型:
multipart/form-data
认证方式
- Header:
Authorization: Bearer <token>
请求示例
表单参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_file | file | 否 | 源图像文件(二进制),与 image_url 二选一 |
| image_url | string | 否 | 源图像 URL,与 image_file 二选一 |
| sync | integer | 否 | 是否等待结果就绪:0=异步(默认),1=同步 |
| type | string | 否 | 修复类型:clean=通用放大清晰化,face=人像放大清晰化(单张图片最多同时清晰化 10 个人) |
| scale_factor | integer | 否 | 放大倍数:空=自动缩放,1=不放大,2=2 倍放大,4=4 倍放大 |
| callback_url | string | 否 | 回调通知地址 |
curl 示例
bash
curl -X POST "https://api.gpt.ge/task/pic/scale" \
-H "Authorization: Bearer sk-xxxx" \
-F "image_url=https://example.com/image.jpg" \
-F "sync=1" \
-F "type=clean" \
-F "scale_factor=4"JavaScript (fetch) 示例
javascript
const formData = new FormData();
formData.append('image_url', 'https://example.com/image.jpg');
formData.append('sync', '1');
formData.append('type', 'clean');
formData.append('scale_factor', '4');
fetch('https://api.gpt.ge/task/pic/scale', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxx'
},
body: formData
}).then(r => r.json()).then(console.log);Python(requests)示例
python
import requests
url = 'https://api.gpt.ge/task/pic/scale'
headers = {
'Authorization': 'Bearer sk-xxxx'
}
files = {
'image_url': (None, 'https://example.com/image.jpg')
}
data = {
'sync': '1',
'type': 'clean',
'scale_factor': '4'
}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())返回示例(200)
json
{
"status": 200,
"data": {
"completed_at": 1742687863,
"created_at": 1742687863,
"download_time": 0,
"image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/scale/7df94a60-1b62-40d6-a0f5-abf35bafce75.jpg",
"image_height": 1152,
"image_width": 864,
"processed_at": 1742687862,
"progress": 100,
"return_type": 1,
"state": 1,
"state_detail": "Complete",
"task_id": "7df94a60-1b62-40d6-a0f5-abf35bafce75",
"time_elapsed": 356.4800109863281,
"type": "clean"
}
}注意:该接口使用
multipart/form-data上传图像,建议仅使用image_url或image_file中的一种方式提交源图像。