主题
转绘(Style Transform)
将输入图片按照指定的风格名称进行风格化转绘,生成具有目标艺术风格的图像。
在编辑器中试用:风格转换。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/style-transform |
| 所需 Scope | style_transform 或 * |
| 任务类型 | 异步,返回 taskId |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "原图的公开 HTTPS URL(必填)",
"styleName": "风格名称(必填)",
"count": 1
}参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | 服务端生成 | 调用方请求 ID,用于幂等去重。省略时服务端生成,并在响应里返回 |
url | string | 是 | — | 原图的公开 HTTPS URL |
styleName | string | 是 | — | 风格名称,见下方完整列表,忽略大小写。不在列表中时创建仍返回 taskId,但不会出图 |
count | integer | 否 | 1 | 接口接受 1–4。当前出图固定 1 张,传入其他值不会多出图 |
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 |
本地图片先 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/photo.jpg",
"styleName": "ghibli",
"count": 1
}' \
"https://magiqsight.com/openapi/v1/image/style-transform"响应示例
json
{
"code": 0,
"data": {
"requestId": "req_abc123",
"taskId": "task_xyz"
},
"msg": ""
}获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。
任务成功(status: 1)后,resultType 为 image,结果在 imageUrls。任务失败(status: 2)时,原因在 resultMetadata。
