Skip to content

任务:图片清晰化(无损放大)

简洁描述:使用图片清晰化接口对图像进行无损放大和增强处理。


概览

  • 请求方法:POST
  • 路径:/task/pic/scale
  • 内容类型:multipart/form-data

认证方式

  • Header:Authorization: Bearer <token>

请求示例

表单参数

参数类型必填说明
image_filefile源图像文件(二进制),与 image_url 二选一
image_urlstring源图像 URL,与 image_file 二选一
syncinteger是否等待结果就绪:0=异步(默认),1=同步
typestring修复类型:clean=通用放大清晰化,face=人像放大清晰化(单张图片最多同时清晰化 10 个人)
scale_factorinteger放大倍数:空=自动缩放,1=不放大,2=2 倍放大,4=4 倍放大
callback_urlstring回调通知地址

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_urlimage_file 中的一种方式提交源图像。