主题
SVG 转 DXF(SVG to DXF)
将 SVG 矢量图转换为 DXF CAD 文件,便于导入激光切割、雕刻或 CAD 软件。
在编辑器中试用:SVG 转 DXF。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/svg2dxf |
| 所需 Scope | svg2dxf 或 * |
| 任务类型 | 异步,返回 taskId;成功时 taskType 为 svg2dxf |
输入通常来自 图片转 SVG 的结果,或自行上传的 SVG 文件 URL。
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"svgUrl": "SVG 文件的公开 HTTPS URL(必填)"
}参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
requestId | string | 否 | 调用方请求 ID,用于幂等去重 |
svgUrl | string | 是 | SVG 文件的公开 HTTPS URL |
svgUrl 须为服务能访问的 HTTPS 地址。本地 SVG 先调用 POST /images/upload,把返回的 data.url 作为 svgUrl。
请求示例
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"svgUrl": "https://example.com/logo.svg"
}' \
"https://magiqsight.com/openapi/v1/image/svg2dxf"响应示例
json
{
"code": 0,
"data": {
"requestId": "req_abc123",
"taskId": "task_xyz"
},
"msg": ""
}获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。
任务成功(status: 1)后,resultType 为 dxf,结果在 dxfUrls。任务失败(status: 2)时查看 resultMetadata。
任务成功时的结果示例:
json
{
"taskType": "svg2dxf",
"status": 1,
"resultType": "dxf",
"dxfUrls": ["https://s3.magiqsight.com/private/xxx.dxf"],
"imageUrls": []
}