导出 SVG

API PLAYGROUND

导出 SVG

POST /api/render-svg

环境配置

Base URL 和 Authorization 修改后自动保存，供本站 Playground 共用。

Base URL服务地址，请求路径固定为 /api/render-svg。

请求头配置

Authorization 必填Bearer API Key，格式为 Bearer <API_KEY>。如何鉴权？

Content-Type接口固定接收 application/json。

x-request-id 可选业务请求标识，省略时由服务生成。

请求体配置

content 必填 · FileContentLatest完整项目内容，对应文档中的 content。粘贴 JSON 或导入 .algeo 文件。{ "messages": [], "slides": [ { "definitions": [ { "kind": "primitive", "id": "A", "source": "Point(?, ?)", "label": "{{id}}" }, { "kind": "primitive", "id": "B", "source": "Point(?, ?)", "label": "{{id}}" }, { "kind": "primitive", "id": "a", "source": "Segment(A, B)" }, { "kind": "primitive", "id": "C", "source": "a.midpoint", "label": "{{id}}" }, { "kind": "primitive", "id": "b", "source": "Arc(C, A, B)" }, { "kind": "primitive", "id": "D", "source": "Point(?, ?)", "label": "{{id}}" }, { "kind": "primitive", "id": "E", "source": "Point(?, ?)", "label": "{{id}}" }, { "kind": "primitive", "id": "F", "source": "Point(?, ?)", "label": "{{id}}" }, { "kind": "primitive", "id": "c", "source": "Polygon([D, E, F])" }, { "kind": "primitive", "id": "d", "source": "c.edge(1)", "parent": "c", "inheritStyle": true }, { "kind": "primitive", "id": "f", "source": "c.edge(2)", "parent": "c", "inheritStyle": true }, { "kind": "primitive", "id": "g", "source": "c.edge(3)", "parent": "c", "inheritStyle": true } ], "uvarMap": [ [ "A.0", -1.7920001220703128 ], [ "A.1", 3.54400146484375 ], [ "B.0", -2.24 ], [ "B.1", -1.3679992675781252 ], [ "D.0", 1.9999999999999996 ], [ "D.1", 3.680001220703125 ], [ "E.0", -0.5040002441406255 ], [ "E.1", 0.8240002441406249 ], [ "F.0", 2.336002197265625 ], [ "F.1", -1.4959985351562501 ] ], "styleSheet": { "background": {}, "xaxis": {}, "yaxis": {}, "xaxis3d": {}, "yaxis3d": {}, "zaxis3d": {}, "workingPlane": {}, "grid": {}, "types": [], "typeLabels": [], "primitives": [ [ "c", { "color": "#9C27B0", "regionOpacity": 0, "lineWidth": 16, "lineOpacity": 100 } ], [ "b", { "lineOpacity": 100, "color": "#388E3C", "lineWidth": 16, "regionOpacity": 0 } ], [ "a", { "lineOpacity": 100, "color": "#388E3C", "lineWidth": 16, "regionOpacity": 0 } ], [ "D", { "hidden": true } ], [ "E", { "hidden": true } ], [ "F", { "hidden": true } ], [ "B", { "hidden": true } ], [ "C", { "hidden": true } ], [ "A", { "hidden": true } ], [ "d", { "regionOpacity": 0, "lineOpacity": 100, "lineWidth": 16 } ], [ "f", { "regionOpacity": 0, "lineOpacity": 100, "lineWidth": 16 } ], [ "g", { "regionOpacity": 0, "lineOpacity": 100, "lineWidth": 16 } ] ], "primitiveLabels": [], "typeLabels3d": [], "primitiveLabels3d": [], "textType": {}, "texts": [], "sliderType": {}, "sliders": [], "buttonType": {}, "buttons": [], "types3d": [], "primitives3d": [], "imageType": {}, "images": [], "elementLayers": [] }, "doc": [], "camera": { "kind": "2d", "offset": [ 0, 0 ], "scale": 50 }, "viewBounds": { "minX": -4.261999206542969, "maxX": 4.4740014648437505, "minY": -3.112000732421876, "maxY": 5.175999755859376, "scale": 50 } } ], "metadata": { "version": "11" } }

导入项目

slideIndex 可选 · number从 1 开始的画板序号，留空使用默认值 1。

template 可选 · object渲染母版 JSON 对象，可从大角几何母版页面下载。

transparent 可选 · boolean是否跳过背景色填充。

视图模式自动 · 使用画板视图viewBound · 指定 2D 视口仅支持 2D SVG；自动模式省略 viewBound，使用画板保存的视口。

scale 可选 · number每逻辑单位的像素数，正数；留空沿用画板相机缩放。

响应

发送请求后，在这里查看 HTTP 状态码和响应内容。

POST /api/render-svg

Base URL： https://api.dajiaoai.com

接口地址： POST /api/render-svg

接口接收一个符合大角工程文件（.algeo）数据协议的项目内容，渲染指定画板并返回导出文件地址与元数据。

尺寸单位

viewBound 使用画板逻辑坐标，scale 表示每个逻辑单位对应的像素数，返回结果中的 width 和 height 表示图片像素尺寸。工程内字号、线宽等视觉尺寸使用 px；如果你手头的规范使用 pt，请查看尺寸单位与换算。

鉴权方式见鉴权说明。

导出 2D SVG，不接收 pixelRatio。

请求头

请求头	类型	必填	说明
Authorization	string	是	Bearer API Key，格式为 Bearer <API_KEY>，无默认值。
Content-Type	string	是	固定为 application/json。
x-request-id	string	否	业务请求标识，省略时服务自动生成 UUID。

请求体

字段	类型	必填	说明
content	FileContentLatest	是	要渲染的完整项目内容，无默认值，格式见大角工程文件（.algeo）数据协议。
slideIndex	number	否	目标画板序号，为从 1 开始的正整数，默认 1。
template	object	否	渲染母版，省略时沿用目标画板现有样式。可在大角几何母版页面下载母版数据。
transparent	boolean	否	是否跳过背景色填充。
viewBound	{ left: number; right: number; bottom: number; top: number; }	否	逻辑视口边界，传入对象时四个属性均必填，且需为有限数值；要求 left < right 且 bottom < top。省略时使用目标画板保存的相机视口。
scale	number	否	相机缩放比例（每逻辑单位对应的像素数），正数。省略时使用目标画板当前 camera.scale。

请求示例

将主站或 SDK 导出的完整项目保存为 project.algeo；以下示例使用 jq 将项目内容放入请求的 content 字段。

jq '{
  content: .,
  slideIndex: 1,
  viewBound: {
    left: -10,
    right: 10,
    bottom: -10,
    top: 10
  },
  scale: 50
}' project.algeo | \
  curl -X POST https://api.dajiaoai.com/api/render-svg \
    -H "Authorization: Bearer djo_xxx" \
    -H "Content-Type: application/json" \
    -H "x-request-id: render-svg-demo-001" \
    --data-binary @-

成功响应

成功返回 200 OK：

{
  "success": true,
  "url": "https://dl.easeplay.vip/dajiao-open/dev/mcp/customer-id/session-id/4fa2bc.svg",
  "filename": "4fa2bc.svg",
  "objectKey": "dajiao-open/dev/mcp/customer-id/session-id/4fa2bc.svg",
  "slideIndex": 1,
  "viewBound": {
    "left": -10,
    "right": 10,
    "bottom": -10,
    "top": 10
  },
  "width": 768,
  "height": 768,
  "scale": 50,
  "mimeType": "image/svg+xml",
  "size": 18234
}

失败响应

见渲染接口失败响应。