转绘（Style Transform）

将输入图片按照指定的风格名称进行风格化转绘，生成具有目标艺术风格的图像。

基本信息

项目	值
接口路径	POST /image/style-transform
所需 Scope	style_transform 或 *

| 任务类型 | 异步，返回 taskId |

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "原图的公开 HTTPS URL（必填）",
  "styleName": "风格名称（必填）",
  "count": 1
}

参数说明

参数	类型	必填	默认值	说明
requestId	string	否	null	调用方请求 ID，用于幂等去重
url	string	是	—	原图的公开 HTTPS URL
styleName	string	是	—	风格名称，见下方完整列表
count	integer	是	1	生成图像数量（1 ~ 4）

styleName 完整取值列表

styleName 值	风格说明
3d_chibi	3D Chibi 卡通风格
american_cartoon	美式卡通风格
clay_toy	粘土玩具风格
ghibli	吉卜力动画风格
jojo	JoJo 漫画风格
lego	乐高积木风格
line	线稿风格
oil_painting	油画风格
paper_cutting	剪纸风格
pixel	像素风格
pop_art	波普艺术风格
rick_morty	Rick and Morty 风格
van_gogh	梵高油画风格
chinese_ink	中式水墨风格
new_chinese_ink	新中式水墨风格
watercolor	水彩风格
fashion_watercolor	时尚水彩插画风格
low_poly	Low Poly 低多边形风格
3d_figure	3D 手办风格
child_book_illustration	儿童书手绘插画风格
vector_illustration	矢量插画风格
fresh_illustration_1	清新插画风格 1
fresh_illustration_2	清新插画风格 2

---

请求示例

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "styleName": "ghibli",
    "count": 1
  }' \
  "https://magiqsight.com/openapi/v1/image/style-transform"

响应示例

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

获得 taskId 后，通过 GET /tasks/{taskId} 轮询结果，结果中包含生成图像的 URL。