使用指南

AI 智能排版 — 将原始文本自动排版为精美的小红书卡片

功能简介

• 自动生成排版： 输入一段没有格式的纯文本，AI 会自动按小红书爆款笔记的结构（加标题、分段落、加粗重点）进行 Markdown 排版。
• 多种使用方式： 可通过网页编辑器逐篇操作，也可通过 API 对接飞书等工具实现批量自动化。

场景一：在网页编辑器中使用

适合逐篇操作、即时预览和下载图片。

场景二：在飞书多维表格中批量使用

适合多篇文案批量自动排版，无需逐条手动操作。

从编辑器获取完整 cURL

先在 网页编辑器 中完成以下操作：

1. 输入 API Key 并保存。
2. 选择一个模板，按需调整字号、颜色、行距等样式参数。
3. 点击右侧面板的「复制 cURL 命令」按钮。

您会得到一段类似下面的完整 cURL：

curl -X POST https://xhs-textcard.site/api/format \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tc_live_abc123..." \
  -d '{
    "text": "{{原始文案}}",
    "template": "elegant-book",
    "config": {
        "fontSize": 15,
        "lineHeight": 2.2,
        "bgColor": "#F5F5DC",
        "textColor": "#333333",
        ...
    }
  }'

2

配置自动化流程

点击多维表格右上角的「创建自动化流程」：

• 触发条件： 【新增/修改的记录满足条件时】->【状态】等于 待排版 时触发。
• 执行动作： 发送 HTTP 请求。
• URL： https://xhs-textcard.site/api/format
• Method： POST

Headers —— 对应 cURL 中 -H 的两行：

Key	Value
Content-Type	application/json
Authorization	Bearer tc_live_替换为你的Key

Body —— 对应 cURL 中 -d 后面的 JSON：

格式选择 JSON，把 cURL 的 -d 后面花括号 { ... } 整段粘贴即可，{{原始文案}} 需要手动点击+号添加值 -> 【第一步满足条件的记录】 -> 【原始文案】列变量：

要点：
• "template" 和 "config" — 保持从编辑器复制过来的原值不动，它们决定了最终排版使用哪个模板和哪套样式参数。

Response Body —— 告诉飞书如何解析响应：

在 HTTP 请求节点的「Response Body」中粘贴一段示例 JSON，飞书会据此识别可用的返回字段。您可以直接复制 cURL 测试返回结果，也可以直接复制下面这个例子：

{
    "markdown": "# 示例标题\n\n这是排版后的 **Markdown** 内容...",
    "template": "elegant-book",
    "model_used": "default",
    "editor_url": "https://your-domain/editor.html?template=elegant-book#..."
  }

粘贴后飞书会自动识别出 markdown、template、editor_url 这些字段，后续在「更新记录」动作里点击 + 号即可引用。

3

回写结果

在"发送 HTTP 请求"节点后，继续添加动作「更新记录」：

• 【排版结果】点击+号设为 markdown变量。
• 【预览链接】点击+号设为 editor_url变量。
• 【状态】设为 已完成，表示这一行已经处理成功。

内置模板一览

在飞书调用中，您可以通过 template 参数指定模板风格。如果不传，默认为空白模板 (blank)。

API 参考（开发者）

以下内容面向有开发能力的用户。如果你只用飞书或编辑器，上面的内容已经够用了。

认证

所有接口需要在 Header 携带认证 Token：

Authorization: Bearer tc_live_xxxxxxxxxxxx

POST /api/format

执行正文排版，支持配置自定义参数覆盖。

请求体 (JSON)

响应体 (JSON)

响应头 (Headers)

所有状态为 200 的请求，都会在返回的首部包含额度消耗信息：

代码调用示例 (Node.js)

async function generateTextCard(text) {
  const resp = await fetch('https://xhs-textcard.site/api/format', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer tc_live_YOUR_KEY'
    },
    body: JSON.stringify({
      text: text,
      template: 'notion-style'
    })
  });

  const data = await resp.json();
  if (!resp.ok) {
    console.error(`Error: ${data.message} (${data.error})`);
    return;
  }
  
  console.log('Markdown:', data.markdown);
  console.log('Editor UI:', data.editor_url);
}

其他接口

• GET /api/key-info : 获取当前 Key 的额度与状态。
• GET /api/templates : 获取所有可用模板的列表。

错误码参照