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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

image_file

file

必需

源图像文件（二进制），与 image_url 参数二选一

image_url

string

必需

源图像URL，与 image_file 参数二选一

sync

enum<integer>

可选

是否等待结果就绪并立即返回（默认值：0）。如果设为1，API将会等待结果准备好后立即返回。如果设为0，需要通过任务查询接口获取结果。如果需要大批量请求建议设置为异步(1)。

枚举值:

01

默认值:

0

示例值:

1

type

enum<string>

可选

前景类型：

空 = 自动检测前景类型。（默认）

"person" = 使用人作为前景。

"object" = 使用物品作为前景。

"stamp" = 使用图章作为前景。

枚举值:

personobjectstamp

return_type

enum<integer>

可选

1 = 返回图片的下载URL。（默认）
2 = 以base64字符串形式返回图片。
3 = 以二进制流的形式返回图片（当前只支持同步接口）。

枚举值:

123

默认值:

1

示例值:

1

scale_factor

integer

可选

放大倍数：
留空 = 自动缩放。
1 = 不放大。(长边范围需要在区间[10,4096]内)
2 = 2倍放大。(长边范围需要在区间[10,1024]内)
4 = 4倍放大。(长边范围需要在区间[10,512]内)

示例值:

4

callback_url

string

可选

回调通知地址：如若需要回调通知，可设置该参数，填写API通知url地址

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gpt.ge/visual/scale' \
--form 'image_file=@""' \
--form 'image_url=""' \
--form 'sync="1"' \
--form 'type=""' \
--form 'return_type="1"' \
--form 'scale_factor="4"' \
--form 'callback_url=""'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

completed_at

integer

必需

created_at

integer

必需

download_time

integer

必需

image

string

必需

image_height

integer

必需

image_width

integer

必需

processed_at

integer

必需

progress

integer

必需

return_type

integer

必需

state

integer

必需

state_detail

string

必需

task_id

string

必需

time_elapsed

number

必需

type

string

必需

示例

成功示例1（sync=1）成功示例2（sync=0）

{
  "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?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250322/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250322T235744Z&x-oss-expires=3600&x-oss-signature=e78aae4ef6673d1b5bf38f882a4a7dce2b2891308ddb666d529f299eeffb89b7&x-oss-signature-version=OSS4-HMAC-SHA256",
    "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"
  }
}