POST公开旧版图片圆角裁剪迁移vv1

圆角图片(旧版)

旧 Face_round 完整迁移:把 JPEG/PNG 居中裁成正方形并加自定义半径圆角(透明底),输出 PNG。

/api/Face_round
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

旧 Face_round 完整迁移:把 JPEG/PNG 居中裁成正方形并加自定义半径圆角(透明底),输出 PNG。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
urlstring图片链接(优先)
filestring旧 multipart 文件参数的兼容别名(传 base64)
sizeunion圆角半径 1-2048,默认 20(越界回落 20)
base64string图片 base64(可带 data URI 前缀)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "url": "https://q1.qlogo.cn/g?b=qq&nk=10001&s=640"
}

返回示例

response.json
{
  "code": 1,
  "message": {
    "base64": "<PNG base64>",
    "contentType": "image/png"
  }
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →