旧版 PNG 接口

API PLAYGROUND

旧版 PNG 接口

POST /api/render

环境配置

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

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

请求头配置

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 PNG；自动模式省略 viewBound，使用画板保存的视口。

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

pixelRatio 可选 · number输出设备像素比，正数；默认 1，只放大物理像素尺寸。

响应

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

POST /api/render

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

接口地址： POST /api/render

推荐迁移到新版本

POST /api/render 保留用于兼容已有接入，仅支持 2D PNG。新接入请使用 POST /api/render/v2，已有调用建议在更新时迁移。

迁移到 v2

迁移时保留 content、slideIndex、template 与顶层 pixelRatio，将 viewBound 的四个边界和 scale 放入 view2D：

{
  "pixelRatio": 2,
  "view2D": {
    "left": -10,
    "right": 10,
    "bottom": -10,
    "top": 10,
    "scale": 50
  }
}

以上仅为视图参数片段，完整请求必须包含 content。服务按目标画板类型选择渲染模式；同时省略两个视图时，使用固定视图或协议默认值。覆盖 3D 视图参数使用 view3D，请求角度使用 yawDeg、pitchDeg 等度数字段。顶层 pixelRatio 默认 1；视图内 view2D.pixelRatio、view3D.pixelRatio 保留兼容且优先级更高。默认值和裁剪参数详见 PNG v2。

旧版请求参数

旧版接口的 Authorization、Content-Type、x-request-id 请求头，以及 content、slideIndex、template 字段与新版 PNG 接口一致，此外还接收：

字段	类型	必填	说明
viewBound	object	否	逻辑视口边界，格式为 { left, right, bottom, top }，要求 left < right 且 bottom < top。省略时使用目标画板当前 camera。
scale	number	否	相机缩放比例（每逻辑单位对应的像素数），正数。省略时使用目标画板当前 camera.scale。
pixelRatio	number	否，仅 /api/render	PNG 输出像素倍率，必须是正的有限数，默认 1。保持逻辑视口和相机缩放不变，将 PNG 的物理宽高按此倍率放大。SVG 和 TikZ 接口不接收此字段。
transparent	boolean	否	是否跳过背景色填充。

旧版请求与响应示例

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

jq '{
  content: .,
  slideIndex: 1,
  viewBound: {
    left: -10,
    right: 10,
    bottom: -10,
    top: 10
  },
  scale: 50,
  pixelRatio: 2,
  template: {
    backgroundStyle: {
      background: { color: "#ffffff" },
      grid: {},
      xaxis: {},
      yaxis: {}
    },
    defaultStyle: {
      types: [["Point", { pointSize: 1, color: "#000000" }]],
      typeLabels: [],
      textType: {},
      sliderType: {},
      buttonType: {}
    }
  }
}' project.algeo | \
  curl -X POST https://api.dajiaoai.com/api/render \
    -H "Authorization: Bearer djo_xxx" \
    -H "Content-Type: application/json" \
    -H "x-request-id: render-demo-001" \
    --data-binary @-

成功返回 200 OK：

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

pixelRatio 只改变 PNG 的物理像素尺寸，不改变 viewBound 或相机 scale。最终尺寸会四舍五入为整数：

width = round(logical canvas width × pixelRatio)
height = round(logical canvas height × pixelRatio)

本例的视口宽高均为 20 个逻辑单位，scale 为 50，因此逻辑渲染尺寸为 1000 × 1000；当 pixelRatio 为 2 时，返回的 width、height 以及实际 PNG 尺寸均为 2000 × 2000。最终宽度和高度均不得超过 2048 像素。