Skip to content

图片转 SVG(To SVG v2) ​

把位图转成 SVG。

在编辑器中试用:图转 SVG。

基本信息 ​

项目值
接口路径POST /image/to-svg/v2
所需 Scopeto_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": ""
}

参数说明 ​

参数类型必填默认值说明
requestIdstring否服务端生成调用方请求 ID,用于幂等去重。省略时由服务端返回
urlstring是—服务能访问的 HTTPS 原图地址
formatstring否svg当前只接受 svg
vectorModestring否autoauto、fully-automatic、basic、advanced。基本模式用 basic
imageTypestring否autoauto、photograph、anti-aliased、not-anti-aliased
detailLevelstring否autoauto、low、medium、high
colorModestring否autoauto、unlimited、custom、two
numColorsinteger否00 为自动。仅 custom 时为 2–256
palettestring否空逗号分隔的 #RRGGBB 或 #RRGGBBAA。two 可不传,传入时正好 2 色;custom 时数量要和 numColors 一致
flattenstring否autoauto、preserve、white、custom
flattenColorstring否空#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。

参数默认说明
conversionModecolorcolor 或 blackwhite
numColors16仅彩色
threshold128仅黑白,0–255
detailLevelmediumlow、medium、high
backgroundRecttrue仅黑白

v1 没有图像类型、色板和透明铺底。新接入请用 v2。

妙图设计 API Beta