创建图片变清晰任务

开发中

POST

/api/tasks/visual/scale

创建图片变清晰任务
图片大小: 不超过 15 MB
图片来源：文件上传（二进制）或从 URL 下载

请求参数

Query 参数

string

可选

Header 参数

X-API-KEY

string

必需

string

可选

Body 参数multipart/form-data

image_file

string

可选

源图像文件（二进制）。（如果此参数存在，则其他图像源参数必须为空）

image_url

string

可选

源图像URL。(如果存在此参数，则其他图像源参数必须为空)

sync

integer

可选

是否等待结果就绪并立即返回（默认值：0）。如果设为1，API将会等待结果准备好后立即返回。如果设为0，API将返回 task_id，稍后可通过 /{task_id} 端点获取结果。请注意，请求提交后，结果最多只会保留1个小时。

type

string

可选

修复类型：
"clean" = 通用放大清晰化。
"face" = 人像放大清晰化。(1张图片中，最多仅能同时变清晰10个人)

scale_factor

integer

可选

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

return_type

integer

可选

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

string

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

status

integer

必需

200
任务创建成功。
400
客户端参数传递错误。请检查参数是否缺失或值是否正确
401
认证失败。请检查X-API-KEY是否正确或者服务是否开通
429
请求频率超出QPS限制（默认QPS为2）。请放缓请求速率，或者联系商务提升QPS限制

message

string

必需

data

object

必需

task_id

string

必需

示例

{
  "status": 200,
  "message": "ok",
  "data": {
    "task_id": "94806a3f-1173-4afb-9bcc-3ff19c0981f4"
  }
}

修改于 2024-08-25 07:35:41

获取抠图结果

获取图片变清晰结果