**版本：202601**

# 创建 AI 卡片

**POST** `/openapi/2026-01/themes/edit-sessions/:oseid/gen-blocks`

在编辑会话中用 liquid 代码（必须含 `{% schema %}` 标签）创建一张 AI 卡片。响应里的 `settings` 是卡片的完整默认配置，可以直接用来把卡片放到页面上。

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `content` string (required)

  卡片 liquid 代码，必须含 schema 标签。其中的 `schema.name` 是商家可见的显示名，无唯一性要求

```json
{
  "content": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `revert_id` string

    撤销本次新建的凭据（见 gen-blocks/revert）
  - `settings` object

    卡片的完整默认配置——schema 全量内容，其中 `type` 即用于页面编排的 `card_type`

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "revert_id": "string",
    "settings": {}
  }
}
```