主题
头像贴纸(Head Sticker)
为人像照片生成带包边的头像贴纸(大头贴),可调整包边厚度、颜色与裁剪留白。
在编辑器中试用:头像贴纸。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/head-sticker |
| 所需 Scope | head_sticker(规范名)或别名 head-sticker,或 * |
| 任务类型 | 异步,返回 taskId;成功时 taskType 为 head-sticker |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "人像原图的公开 HTTPS URL(必填)",
"borderSize": 20,
"borderColor": "#FFFFFF",
"edgeSmoothness": 20,
"cropPadding": 16,
"preserveOriginalSize": false
}参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | 服务端生成 | 调用方请求 ID,用于幂等去重。省略时服务端生成,并在响应里返回 |
url | string | 是 | — | 人像原图的公开 HTTPS URL |
borderSize | integer | 否 | 20 | 包边厚度(像素) |
borderColor | string | 否 | #FFFFFF | 包边颜色(十六进制) |
edgeSmoothness | integer | 否 | 20 | 包边平滑度 |
cropPadding | integer | 否 | 16 | 裁剪居中留白 |
preserveOriginalSize | boolean | 否 | 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。
