**版本：202601**

# 渲染模板画布快照

**POST** `/openapi/2026-01/themes/page-builder/summary`

传入模板 id 或完整的画布数据，返回画布的文本快照；每个节点带 `#path` 编号，可用于在编辑操作里定位节点。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `schema` object

  完整的画布数据（Page Builder 的 ProjectData）；与 `id` 二选一，推荐用 `id`
- `detail_level` string

  详细程度：`minimal`、`tiered`、`verbose`，默认 `minimal`
- `detailed_node_ids` string[]

  指定要展开细节的节点 path，如 `0.1.2`
- `id` string

  要生成快照的模板 id，服务端按 id 读取画布数据。与 `schema` 二选一，推荐用 `id`，避免在请求里传完整的画布数据
- `type` string

  按 id 拉取时的模板类型：`custom`（默认，自定义卡片模板）、`global`（公共模板）。仅按 id 拉取时生效，其它值会被拒绝。与保存高级卡片时的 `origin` 取值含义相同

```json
{
  "schema": {},
  "detail_level": "string",
  "detailed_node_ids": [
    "string"
  ],
  "id": "string",
  "type": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `text` string

    画布文本快照
  - `timings` object

    耗时统计

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "text": "string",
    "timings": {}
  }
}
```