主题
图片转 SVG(To SVG v2)
把位图转成 SVG。
在编辑器中试用:图转 SVG。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/to-svg/v2 |
| 所需 Scope | to_svg(规范名)或别名 2svg,或 * |
| 任务类型 | 异步,返回 taskId;成功时 taskType 为 2svg,resultType 为 svg |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "https://s3.magiqsight.com/static/sample_chinese_miao.png",
"format": "svg",
"vectorMode": "auto",
"imageType": "auto",
"detailLevel": "auto",
"colorMode": "auto",
"numColors": 0,
"palette": "",
"flatten": "auto",
"flattenColor": ""
}参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | 服务端生成 | 调用方请求 ID,用于幂等去重。省略时由服务端返回 |
url | string | 是 | — | 服务能访问的 HTTPS 原图地址 |
format | string | 否 | svg | 当前只接受 svg |
vectorMode | string | 否 | auto | auto、fully-automatic、basic、advanced。基本模式用 basic |
imageType | string | 否 | auto | auto、photograph、anti-aliased、not-anti-aliased |
detailLevel | string | 否 | auto | auto、low、medium、high |
colorMode | string | 否 | auto | auto、unlimited、custom、two |
numColors | integer | 否 | 0 | 0 为自动。仅 custom 时为 2–256 |
palette | string | 否 | 空 | 逗号分隔的 #RRGGBB 或 #RRGGBBAA。two 可不传,传入时正好 2 色;custom 时数量要和 numColors 一致 |
flatten | string | 否 | auto | auto、preserve、white、custom |
flattenColor | string | 否 | 空 | #RRGGBB 或 #RRGGBBAA,仅 flatten=custom |
auto 或 unlimited 不能同时带 numColors 或 palette。two 不能带 numColors。
url 须为服务能访问的 HTTPS 地址。本地文件先调用 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://s3.magiqsight.com/static/sample_chinese_miao.png"
}' \
"https://magiqsight.com/openapi/v1/image/to-svg/v2"混色插画,中等细节,8 色:
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://s3.magiqsight.com/static/sample_chinese_miao.png",
"vectorMode": "basic",
"imageType": "anti-aliased",
"detailLevel": "medium",
"colorMode": "custom",
"numColors": 8,
"flatten": "preserve"
}' \
"https://magiqsight.com/openapi/v1/image/to-svg/v2"本地文件
源图在本机时,不要把本地路径写进 url。先 POST /images/upload,取出 data.url,再提交 POST /image/to-svg/v2。上传字段和限制见 图片上传。
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-F "file=@/path/to/local.png;type=image/png" \
"https://magiqsight.com/openapi/v1/images/upload"从响应里取出 data.url,再提交转 SVG:
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "<上一步返回的 data.url>"
}' \
"https://magiqsight.com/openapi/v1/image/to-svg/v2"响应示例
json
{
"code": 0,
"data": {
"requestId": "req_abc123",
"taskId": "task_xyz"
},
"msg": ""
}获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。
任务成功(status: 1)后,resultType 为 svg,文件地址在 svgUrls。
如需转成 CAD 文件,把 SVG 地址交给 SVG 转 DXF。
json
{
"taskType": "2svg",
"status": 1,
"resultType": "svg",
"svgUrls": ["https://example.com/outputs/logo.svg"],
"imageUrls": []
}任务失败(status: 2)时查看 resultMetadata,例如图片 URL 无法下载。
v1 兼容
POST /image/to-svg 仍接受原来的彩色 / 黑白参数,Scope 相同。成功时同样是 taskType=2svg、resultType=svg,结果在 svgUrls。
| 参数 | 默认 | 说明 |
|---|---|---|
conversionMode | color | color 或 blackwhite |
numColors | 16 | 仅彩色 |
threshold | 128 | 仅黑白,0–255 |
detailLevel | medium | low、medium、high |
backgroundRect | true | 仅黑白 |
v1 没有图像类型、色板和透明铺底。新接入请用 v2。
