返回调试台

小红书笔记同步飞书 API

POST /api/plugins/agent/sync

接口描述

输入小红书笔记链接，自动采集内容（含视频语音转文字）并同步至飞书多维表格。支持自动创建缺失字段。

请求参数

参数名 类型 必选 描述
apiKey string 是 用户 API Key（推荐通过 Header Authorization: Bearer YOUR_KEY 传递，也可以作为 Query 参数）
xhsUrl string 是 小红书笔记链接（支持短链和长链）
feishuUrl string 是 飞书多维表格链接（支持 Wiki 或 Base 链接）
appId string 是 飞书 App ID（需开通多维表格权限）
appSecret string 是 飞书 App Secret
cookie string 否 小红书 Cookie（提供登录态 Cookie 可获取更多数据）
useOwnKey boolean 否 是否使用自己的阿里云 API Key（默认为 false）。
如果开启，需先在用户中心配置阿里云 Key，费用固定为 1 点。

计费说明

本接口采用组合计费模式：

  • 基础费用：每次调用固定扣除 2 点（1 点采集 + 1 点同步）。
  • 时长费用：如果笔记包含视频且转写成功，额外收取 0.15 点/秒（向上取整）。
  • 自有 Key 优惠：如果参数 useOwnKey=true，则仅收取固定费用 1 点。

👉 用量管理：您可以前往 API 插件中心 查看剩余用量及进行充值。

响应参数

参数名 类型 描述
code number 状态码，0 表示成功
msg string 提示信息（成功或失败原因）
logs array 执行日志列表（包含详细的执行步骤和耗时）
record_id string 飞书多维表格记录 ID

示例

请求示例

curl -X POST "https://cyanlis.cn/api/plugins/agent/sync" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "xhsUrl": "https://www.xiaohongshu.com/explore/...", "feishuUrl": "https://ai.feishu.cn/wiki/...", "appId": "cli_...", "appSecret": "...", "useOwnKey": false }'

响应示例

Loading...

错误码

错误码 描述 解决方案
401 Unauthorized API Key 无效或过期，请检查 Key 是否正确
400 Bad Request 请求参数错误（如 URL 为空或飞书配置错误）
403 Forbidden 余额不足或权限受限
500 Internal Server Error 服务器内部错误、转写失败或同步失败