Skip to content

头像贴纸(Head Sticker) ​

为人像照片生成带包边的头像贴纸(大头贴),可调整包边厚度、颜色与裁剪留白。

在编辑器中试用:头像贴纸。

基本信息 ​

项目值
接口路径POST /image/head-sticker
所需 Scopehead_sticker(规范名)或别名 head-sticker,或 *
任务类型异步,返回 taskId;成功时 taskType 为 head-sticker

请求参数 ​

json
{
  "requestId": "可选,调用方自定义唯一 ID",
  "url": "人像原图的公开 HTTPS URL(必填)",
  "borderSize": 20,
  "borderColor": "#FFFFFF",
  "edgeSmoothness": 20,
  "cropPadding": 16,
  "preserveOriginalSize": false
}

参数说明 ​

参数类型必填默认值说明
requestIdstring否服务端生成调用方请求 ID,用于幂等去重。省略时服务端生成,并在响应里返回
urlstring是—人像原图的公开 HTTPS URL
borderSizeinteger否20包边厚度(像素)
borderColorstring否#FFFFFF包边颜色(十六进制)
edgeSmoothnessinteger否20包边平滑度
cropPaddinginteger否16裁剪居中留白
preserveOriginalSizeboolean否false是否保持原始尺寸

本地人像先 POST /images/upload,把返回的 data.url 作为 url。


请求示例 ​

bash
curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/portrait.jpg",
    "borderSize": 24,
    "borderColor": "#FFFFFF"
  }' \
  "https://magiqsight.com/openapi/v1/image/head-sticker"

响应示例 ​

json
{
  "code": 0,
  "data": {
    "requestId": "req_abc123",
    "taskId": "task_xyz"
  },
  "msg": ""
}

获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。

任务成功(status: 1)后,resultType 为 image,结果在 imageUrls。任务失败(status: 2)时,原因在 resultMetadata。

妙图设计 API Beta