Skip to main content
POST
创建图片压缩任务

请求头

X-API-KEY
string
必填

请求体

multipart/form-data
image_file
string

源图像文件(二进制)。(如果此参数存在,则其他图像源参数必须为空)

示例:

""

image_url
string

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

示例:

""

sync
integer

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

示例:

""

format
string

处理后的输出格式。若原格式为 jpg 或 png 或 webp则保持原格式,否则返回服务器自动推荐的格式。

示例:

""

return_type
integer

1 = 返回图片的下载URL。 2 = 以base64字符串形式返回图片。

示例:

""

quality
integer

图片质量,取值范围:0 - 100, 默认为 75。(如果存在此参数,则kbyte参数必须为空) 0100为由强弱的压缩程度,1最强,100最弱

示例:

""

kbyte
integer

指定压缩后图片大小,单位为KB,取值范围:0 - 51200。(如果存在此参数,则quality参数必须为空)

若返回的编码格式为png,则不支持指定文件大小压缩

示例:

""

width
integer

压缩后图片宽度,取值范围:0 - 8000, 默认为原图宽度。若无 height 参数, 则保持图片宽高比。

示例:

""

height
integer

压缩后图片高度,取值范围:0 - 8000, 默认为原图高度。若无 width 参数, 则保持图片宽高比。

示例:

""

响应

200 - application/json

请求成功

status
integer
必填

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

message
string
必填
data
object
必填