创建 AI 卡片

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

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

请求

Path参数

oseid string必填

编辑会话 ID

application/json

请求体

请求体必填

contentstring必填

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

示例

json

{
  "content": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

revert_idstring

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

settingsobject

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

示例

json

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