开发者/能力参考（308 个）

能力参考：308 个能力逐个说明

字流桌面端的每个功能都是一个「能力」（通道），名字形如 creation:brief。这里列出全部：做什么、参数、返回、风险级、会不会花云点、调用示例。和桌面端 GET /v1/catalog 是同一份数据，随版本更新。

怎么读

调用：POST /v1/call/<能力名>，请求体就是参数对象（MCP 里用 ziliu_call，channel 填能力名、payload 填参数）。
风险级：只读（直接调）、改本地（要创作者版及以上）、会公开（用户打开开关 + 带 "confirm": true）、不开放（永远 403）。
花云点：用字流 AI 时按用量扣；用户用自己的模型密钥就不扣。
示例里的 xxx 换成真实 id：内容 id 从 os:content:list 拿，平台稿 id 从 os:content:get 的 drafts 拿，任务 id 从 queue:board 拿。
平台 id：wechat_mp 公众号、zhihu 知乎、juejin 掘金、xiaohongshu 小红书、douyin 抖音、video_wechat 视频号、bilibili B 站、kuaishou 快手、weibo 微博、x、zsxq 知识星球、toutiao 头条号…完整清单见云端 GET /v1/platforms。

全部能力

字流 3.1.7 · 共 308 个：只读 89、改本地 149、会公开 14、不开放 56；51 个会花云点。调用：POST /v1/call/<能力名>，请求体就是参数。

写稿 `creation:`

一句话成稿、提炼内核、按平台出稿、改写、质检、补发布字段

creation:brief改本地花云点

一句话成稿的第一步：一句话（+ 你的亲历）→ 新建母稿、联网补料、提炼内核，返回 contentId；之后用 creation:generateBatch 出各平台稿

mode: article（图文）/ video（视频）
brief: 一句话选题
firsthand: 可选，你的真实经历和数字（AI 不会替你编）
targets: 可选，要出哪些平台稿 [{ platform, kind }]

返回 { contentId, core, brief?, title }

看调用示例

POST /v1/call/creation:brief
{
  "mode": "article",
  "brief": "一人公司第一年，我花了多少钱在 AI 订阅上",
  "firsthand": "我自己一年订阅花了 1.7 万，最贵的是 Claude Max",
  "targets": [
    {
      "platform": "wechat_mp",
      "kind": "long_text"
    },
    {
      "platform": "xiaohongshu",
      "kind": "short_text"
    }
  ]
}

creation:publishCheck改本地

发布前检查：每篇平台稿能不能送（blockers 挡住的原因）、最好看一眼的（warnings）、送出去会怎样（route）。送发布前先跑

contentId: 内容 id

看调用示例

POST /v1/call/creation:publishCheck
{
  "contentId": "content_xxx"
}

creation:metaFill改本地花云点

给一篇平台稿补齐发布字段（标签、话题、摘要等），只补缺的

draftId: 平台稿 id

看调用示例

POST /v1/call/creation:metaFill
{
  "draftId": "draft_xxx"
}

creation:tietuGet改本地

读一篇长文的公众号贴图草稿（大纲、每页正文、标签）

contentId: 内容 id

看调用示例

POST /v1/call/creation:tietuGet
{
  "contentId": "content_xxx"
}

creation:tietuGenerate改本地花云点

从长文生成公众号贴图草稿（会花云点）。stage：outline 先出大纲 / body 再写每页

contentId: 内容 id
stage: outline | body
requiredTags: 必带标签（可选，不填用账号设置）
accountId: 公众号账号 id（可选）

看调用示例

POST /v1/call/creation:tietuGenerate
{
  "contentId": "content_xxx",
  "stage": "outline"
}

creation:tietuSave改本地

保存对贴图草稿的修改（只改给出的字段）

contentId: 内容 id
patch: 要改的字段

看调用示例

POST /v1/call/creation:tietuSave
{
  "contentId": "content_xxx",
  "patch": {
    "title": "新标题"
  }
}

creation:tietuTagsGet改本地

读贴图必带的标签（按账号，没有就用全局设置）

accountId: 账号 id（可选）

看调用示例

POST /v1/call/creation:tietuTagsGet
{}

creation:tietuTagsSet改本地

设置贴图必带的标签；给 accountId 只改这个号

accountId: 账号 id（可选）
tags: 标签数组

看调用示例

POST /v1/call/creation:tietuTagsSet
{
  "tags": [
    "AI工具"
  ]
}

creation:metaLint改本地

检查一篇平台稿的发布字段（字数上限、必填项），不花云点

platform: 平台 id
meta: 发布字段对象

看调用示例

POST /v1/call/creation:metaLint
{
  "platform": "xiaohongshu",
  "meta": {
    "title": "标题"
  }
}

creation:distill改本地花云点

从母稿提炼内核（观点、证据、金句），写各平台稿前先跑

contentId: 内容 id

看调用示例

POST /v1/call/creation:distill
{
  "contentId": "content_xxx"
}

creation:generateText改本地花云点

按平台写一篇稿（会花云点）。kind：long_text 长文 / short_text 短图文 / short_video 短视频口播稿 / long_video 长视频稿

content: { id, title }
platform: 平台 id
kind: 稿件形态

看调用示例

POST /v1/call/creation:generateText
{
  "content": {
    "id": "content_xxx",
    "title": "标题"
  },
  "platform": "wechat_mp",
  "kind": "long_text"
}

creation:generateBatch改本地花云点

一次写多个平台的稿（生成后自动去 AI 味、量可读性、亲历核查）

content: { id, title }
targets: [{ platform, kind }]

看调用示例

POST /v1/call/creation:generateBatch
{
  "content": {
    "id": "content_xxx",
    "title": "标题"
  },
  "targets": [
    {
      "platform": "wechat_mp",
      "kind": "long_text"
    },
    {
      "platform": "xiaohongshu",
      "kind": "short_text"
    },
    {
      "platform": "douyin",
      "kind": "short_video"
    }
  ]
}

creation:refine改本地花云点

改写一篇平台稿：action 可选 title / hook / cta / casual / formal / shorter / longer / angle / data / humanize（去 AI 味）/ readable（只改形状，变好读）/ custom（配 instruction）。返回改后的正文，不自动保存

draftId: 平台稿 id
action: 改写方式
instruction: 可选，custom 时的要求
selection: 可选，{ start, end } 只改选中部分

返回 { body, changed, aiScore }

看调用示例

POST /v1/call/creation:refine
{
  "draftId": "draft_xxx",
  "action": "custom",
  "instruction": "开头加一句我自己的经历"
}

creation:personaCheck改本地花云点

深度质检：「像不像你」打分 + 观点支撑 / 知识带出 / 体感 / 姿态 / 读得顺逐项（layers），只提醒

draftId: 平台稿 id
cachedOnly: 可选，true 只读缓存不花云点

看调用示例

POST /v1/call/creation:personaCheck
{
  "draftId": "draft_xxx"
}

creation:personaFix改本地花云点

把深度质检里「不像你」的那几句按你的口吻改掉（先跑 creation:personaCheck）

draftId: 平台稿 id

返回 { part, text, changes }

看调用示例

POST /v1/call/creation:personaFix
{
  "draftId": "draft_xxx"
}

creation:styleDna:get只读

作者的写作风格 DNA：从他亲手写的文章算的句长、问句、第一人称、口头表达（样本不够是 null）

看调用示例

POST /v1/call/creation:styleDna:get
{}

creation:styleDna:refresh改本地

按最新的亲手写的文章重算写作风格 DNA

看调用示例

POST /v1/call/creation:styleDna:refresh
{}

creation:lint改本地

规则质检（不花云点）：套话、AI 口头禅、空泛工具名、假设例子、节奏（句长一个样 / 没有单句成段 / 没有问句）、编造经历

text: 正文
platform: 可选，平台 id
lang: 可选，zh / en

看调用示例

POST /v1/call/creation:lint
{
  "text": "正文",
  "platform": "wechat_mp"
}

creation:convert改本地

图文 ⇄ 视频：把一篇图文内容转成口播视频内容，或反过来

contentId: 内容 id
to: article / video

看调用示例

POST /v1/call/creation:convert
{
  "contentId": "content_xxx",
  "to": "video"
}

creation:fixSnippets改本地花云点

按理由改掉平台稿里指定的几句（发布前检查里「这几句可能违规 / 编造」时用）

draftId: 平台稿 id
part: body / header / footer
snippets: 要改的原句
reason: 为什么要改
keywords: 可选，命中的敏感词

看调用示例

POST /v1/call/creation:fixSnippets
{
  "draftId": "draft_xxx",
  "part": "body",
  "snippets": [
    "原句"
  ],
  "reason": "可能被判导流"
}

creation:zsxqVariant改本地花云点

为某个知识星球单独改一版（按星球简介、人数、是否付费调整口吻）

draftId: 知识星球稿 id
group: { id, name, role, intro?, members?, paid? }

看调用示例

POST /v1/call/creation:zsxqVariant
{
  "draftId": "draft_xxx",
  "group": {
    "id": "123",
    "name": "我的星球",
    "role": "owner"
  }
}

creation:generateImage改本地花云点

按提示词生图（会花云点），存进这篇内容的素材

contentId: 内容 id
prompt: 画面描述
count: 可选，几张
aspectRatio: 可选，如 16:9 / 3:4 / 1:1

看调用示例

POST /v1/call/creation:generateImage
{
  "contentId": "content_xxx",
  "prompt": "一张极简风的一人公司工作台",
  "aspectRatio": "16:9"
}

creation:generateMatrix改本地花云点

同一篇内容给矩阵里的多个账号各写一版（口吻按各自定位）

content: { id, title }
accounts: 账号 id 列表
platform: 平台 id

看调用示例

POST /v1/call/creation:generateMatrix
{
  "content": {
    "id": "content_xxx",
    "title": "标题"
  },
  "accounts": [
    "acc_1",
    "acc_2"
  ],
  "platform": "xiaohongshu"
}

creation:tts改本地花云点

一段文字合成配音（会花云点）

text: 要念的文字
voiceId: 可选，音色（见 video:voices）
contentId: 可选，存到哪篇内容

看调用示例

POST /v1/call/creation:tts
{
  "text": "这是一段口播",
  "voiceId": "zh-CN-YunxiNeural"
}

creation:composeVideo改本地花云点

旧版图文成片：口播稿 + 图片 → 配音视频（新流程用 video:plan + video:compose）

contentId: 内容 id
script: 口播稿
images: 图片路径列表
voiceId: 可选

看调用示例

POST /v1/call/creation:composeVideo
{
  "contentId": "content_xxx",
  "script": "口播稿",
  "images": []
}

后台流水线 `pipeline:`

一句话 / 母稿交给后台：写各平台稿 → 配图 → 图集 → 封面 → 发布字段整条跑完，可同时开几条

pipeline:start改本地花云点

交给后台流水线：写各平台稿 → 配图 → 图集 → 封面 → 发布字段整条跑完（同一条内容在跑就返回那条，不重复开）。不等结果，用 pipeline:list 看进度

mode: article / video
contentId: 已有母稿 id（和 brief 二选一）
brief: 一句话成稿：{ brief, firsthand?, topicId? }
targets: [{ platform, kind, durationSec? }]
persona: 可选，人设文字
personaId: 可选
research: 可选，联网补料

看调用示例

POST /v1/call/pipeline:start
{
  "mode": "article",
  "brief": {
    "brief": "国产 Flash 模型谁更省钱"
  },
  "targets": [
    {
      "platform": "zhihu",
      "kind": "long_text"
    },
    {
      "platform": "xiaohongshu_note",
      "kind": "short_text"
    }
  ]
}

pipeline:list只读

后台流水线任务：在跑的、写好等检查的、中断的（每个平台走到哪一步）

pipeline:forContent改本地

某条内容最近的后台任务

contentId: 内容 id

看调用示例

POST /v1/call/pipeline:forContent
{
  "contentId": "content_xxx"
}

pipeline:resume改本地花云点

中断 / 失败的任务接着做：写好的平台不重写，只补没做完的步骤

taskId: 任务 id

pipeline:cancel改本地

停下一个后台任务（正在做的这一步做完就停）

taskId: 任务 id

pipeline:review改本地

标记检查完了（从「待检查」里拿掉）

taskId: 任务 id

pipeline:remove改本地

删掉一条不在跑的任务记录

taskId: 任务 id

内容、平台稿与素材 `os:`

母稿（content）、各平台稿（draft）、素材（asset）的增删改查

os:content:list只读

列出内容（母稿）。status 可选：draft / ready / published

status: 可选

看调用示例

POST /v1/call/os:content:list
{
  "status": "draft"
}

os:content:get只读

取一篇内容的全部信息：母稿正文、各平台稿（drafts）、素材、发布任务

id: 内容 id

返回 { content, drafts, assets }

看调用示例

POST /v1/call/os:content:get
{
  "id": "content_xxx"
}

os:content:save改本地

新建或修改母稿。新建不带 id；kind: article（图文）/ video（视频）；从选题卡开写就带上 topicId

content: { id?, title, kind, body, status, topicId? }

看调用示例

POST /v1/call/os:content:save
{
  "content": {
    "title": "一人公司第一年的账单",
    "kind": "article",
    "body": "母稿正文（Markdown）",
    "status": "draft",
    "topicId": "topic_xxx"
  }
}

os:content:remove改本地

删除一篇内容（连同它的平台稿）

id: 内容 id

看调用示例

POST /v1/call/os:content:remove
{
  "id": "content_xxx"
}

os:draft:update改本地

改某个平台稿的标题 / 正文 / 摘要 / 标签 / 发布字段

id: 平台稿 id
title: 可选
body: 可选
accountIds: 可选，发到哪些账号

看调用示例

POST /v1/call/os:draft:update
{
  "id": "draft_xxx",
  "title": "新标题",
  "body": "正文"
}

os:draft:upsertByPlatform改本地

按（内容, 平台, 形态）新建或覆盖一篇平台稿：自己写好的稿直接放进去

contentId: 内容 id
platformId: 平台 id
kind: 可选，稿件形态
title: 标题
body: 正文
summary: 可选
tags: 可选
settings: 可选，发布字段等

看调用示例

POST /v1/call/os:draft:upsertByPlatform
{
  "contentId": "content_xxx",
  "platformId": "zhihu",
  "kind": "long_text",
  "title": "标题",
  "body": "正文"
}

os:asset:add改本地

给内容加素材（本地文件路径或网址）。口播录像 role 填 source_video，画中画素材填 broll

contentId: 内容 id
type: image / video / audio
name: 文件名
localPath: 本地路径（和 url 二选一）
url: 网址
role: 可选，用途

看调用示例

POST /v1/call/os:asset:add
{
  "contentId": "content_xxx",
  "type": "video",
  "name": "口播.mp4",
  "localPath": "D:/录像/口播.mp4",
  "role": "source_video"
}

os:asset:remove改本地

删一个素材（只删记录，不删你电脑上的文件）

id: 素材 id

看调用示例

POST /v1/call/os:asset:remove
{
  "id": "asset_xxx"
}

os:asset:pick不开放

选文件的对话框（Agent 直接用 os:asset:add 给路径）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

选题 `topics:`

每日选题卡、选题库、热榜、信号、对标作者、节日日历

topics:dailyToday只读

今天的选题卡（字流每天按定位和热点出）

看调用示例

POST /v1/call/topics:dailyToday
{}

topics:daily改本地花云点

重新生成今天的选题（会花云点）

force: 可选，true 不管今天出过没有都重出
accountIds: 可选，只给这些账号出

看调用示例

POST /v1/call/topics:daily
{
  "force": true
}

topics:createManual改本地

把一个想法加进选题库

input: { title, angle?, notes? }

看调用示例

POST /v1/call/topics:createManual
{
  "input": {
    "title": "选题标题",
    "angle": "角度",
    "notes": "备注"
  }
}

topics:pick改本地

把一张选题卡标成「已选」（开写前调；开写本身用 os:content:save 新建内容并带上 topicId）

topicId: 选题 id

看调用示例

POST /v1/call/topics:pick
{
  "topicId": "topic_xxx"
}

topics:competitorComments改本地花云点

读一条对标爆款的公开热评（B 站 / 掘金），归纳读者在问什么、给选题角度

url: 作品链接
title: 作品标题

看调用示例

POST /v1/call/topics:competitorComments
{
  "url": "https://www.bilibili.com/video/BV...",
  "title": "那条视频的标题"
}

topics:list只读

选题库。status 可选 idea（灵感）/ picked（已选）/ drafted（创作中）/ done（已完成）

status: 可选

看调用示例

POST /v1/call/topics:list
{
  "status": "idea"
}

topics:query只读

按条件查选题

accountId: 可选
lane: 可选，hot 热点 / evergreen 常青 / asset 个人资产
forDate: 可选，yyyy-mm-dd
status: 可选，单个或数组
source: 可选
sinceIso: 可选
limit: 可选

看调用示例

POST /v1/call/topics:query
{
  "lane": "hot",
  "limit": 20
}

topics:promote改本地

改一张选题卡的状态

topicId: 选题 id
status: idea / picked / drafted / done

看调用示例

POST /v1/call/topics:promote
{
  "topicId": "topic_xxx",
  "status": "done"
}

topics:remove改本地

从选题库删掉一张卡

id: 选题 id

看调用示例

POST /v1/call/topics:remove
{
  "id": "topic_xxx"
}

topics:hotlist只读

各平台热榜（微博、知乎、B 站、抖音……）

sources: 可选，热榜来源 id 列表

看调用示例

POST /v1/call/topics:hotlist
{}

topics:suggest改本地花云点

从热榜条目里挑适合你的，给出角度（会花云点）

personaCardId: 可选，人设卡
hotItems: 热榜条目
targetPlatforms: 可选

看调用示例

POST /v1/call/topics:suggest
{
  "hotItems": [
    {
      "title": "某条热搜"
    }
  ]
}

topics:recommendV2改本地花云点

按账号定位和关键词推荐选题（会花云点）

accountIds: 可选
keywords: 可选，关键词
perAccountLimit: 可选，每个账号几条

看调用示例

POST /v1/call/topics:recommendV2
{
  "keywords": [
    "Claude Code"
  ],
  "perAccountLimit": 5
}

topics:signals只读

抓一轮选题信号（RSS、开源项目、Skills、提示词等来源）；只传 kind 时读缓存

keywords: 可选，关键词
sources: 可选，来源 id
kind: 可选，信号类型

看调用示例

POST /v1/call/topics:signals
{
  "keywords": "AI 编程"
}

topics:signals:cached只读

读已经抓到的选题信号（不联网）

kind: 可选，信号类型

看调用示例

POST /v1/call/topics:signals:cached
{}

topics:ipProfile只读

你的 IP 画像：选题时用的定位、支柱、人群和近期表现摘要

看调用示例

POST /v1/call/topics:ipProfile
{}

topics:hotWatchNow改本地花云点

马上跑一轮「盘中热点补推」（每天最多 2 张，会花云点）

看调用示例

POST /v1/call/topics:hotWatchNow
{}

topics:calendar:list只读

节日 / 行业日历（内置 + 你自己加的）

看调用示例

POST /v1/call/topics:calendar:list
{}

topics:calendar:save改本地

保存你自己加的日历事件（整表覆盖）

events: [{ title, date, endDate?, note? }]

看调用示例

POST /v1/call/topics:calendar:save
{
  "events": [
    {
      "title": "产品发布会",
      "date": "2026-11-11"
    }
  ]
}

topics:competitors:list只读

对标作者列表

看调用示例

POST /v1/call/topics:competitors:list
{}

topics:competitors:save改本地

新增或修改一个对标作者（套餐有数量上限）

item: { id?, platformId, name, url, ... }

看调用示例

POST /v1/call/topics:competitors:save
{
  "item": {
    "platformId": "bilibili",
    "name": "某 UP 主",
    "url": "https://space.bilibili.com/xxx"
  }
}

topics:competitors:remove改本地

删一个对标作者

id: 对标 id

看调用示例

POST /v1/call/topics:competitors:remove
{
  "id": "cw_xxx"
}

联网检索 `research:`

带来源的联网检索、读网页、检索设置

research:run改本地花云点

联网检索一个问题（带来源）

question: 要查的问题
recencyDays: 可选，只看近几天

看调用示例

POST /v1/call/research:run
{
  "question": "Claude Code 最新版本更新了什么",
  "recencyDays": 30
}

research:search只读

单次搜索（不做归纳），scope 选来源：web / x / weibo / xiaohongshu / zhihu / v2ex

query: 搜索词
scope: 可选，默认 web
count: 可选，条数
recencyDays: 可选

看调用示例

POST /v1/call/research:search
{
  "query": "Claude Code",
  "scope": "web",
  "count": 5
}

research:read改本地

读一个网页的正文

url: http(s) 地址

看调用示例

POST /v1/call/research:read
{
  "url": "https://www.anthropic.com/news"
}

research:settings:get只读

联网检索设置：用哪个搜索、密钥配没配（只返回有没有，不返回密钥）、写稿默认联网没有

看调用示例

POST /v1/call/research:settings:get
{}

research:settings:set改本地

改联网检索设置

webProvider: 可选，网页搜索来源（auto 自动）
xProvider: 可选
writingDefault: 可选，写稿默认联网
copilotDefault: 可选，助手默认联网

看调用示例

POST /v1/call/research:settings:set
{
  "writingDefault": true
}

research:test改本地

试搜一次，看某个来源通不通

scope: web / x / weibo / xiaohongshu / zhihu / v2ex
query: 可选

看调用示例

POST /v1/call/research:test
{
  "scope": "web"
}

research:setKey不开放

保存搜索接口密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

配图与封面 `media:`

截图、按配图位找图、AI 图集、平台封面、知识卡片

media:carousel改本地花云点

短图文的 AI 图集（小红书 3:4、微博 1:1 等，会花云点）

draftId: 平台稿 id

看调用示例

POST /v1/call/media:carousel
{
  "draftId": "draft_xxx"
}

media:cover改本地花云点

给某个平台做封面

draftId: 平台稿 id
platform: 平台 id
title: 可选，封面大字

看调用示例

POST /v1/call/media:cover
{
  "draftId": "draft_xxx",
  "platform": "bilibili",
  "title": "封面大字"
}

media:screenshot改本地

截一个网页（配图 / 证据）

url: 网址
mode: 可选，main 只截正文区

看调用示例

POST /v1/call/media:screenshot
{
  "url": "https://github.com/xxx",
  "mode": "main"
}

media:resolveFigures改本地花云点

按正文里的配图位找图（真实截图优先），回填正文

draftId: 平台稿 id

看调用示例

POST /v1/call/media:resolveFigures
{
  "draftId": "draft_xxx"
}

media:renderCard改本地

把数据渲染成一张图：代码卡 / 知识卡 / 封面 / 场景卡

template: code / knowledge / cover / scene
data: 卡片内容
contentId: 可选，存到哪篇内容
paginate: 可选，内容长时自动分页

看调用示例

POST /v1/call/media:renderCard
{
  "template": "code",
  "data": {
    "code": "npm i -g @anthropic-ai/claude-code",
    "lang": "bash"
  }
}

公众号排版 `themes:`

排版主题、按内容推荐主题、Markdown 渲染成公众号 HTML

themes:list只读

公众号排版主题列表

看调用示例

POST /v1/call/themes:list
{}

themes:meta只读

文章类型和强调色预设（排版用）

看调用示例

POST /v1/call/themes:meta
{}

themes:getDefault只读

你设的默认主题

看调用示例

POST /v1/call/themes:getDefault
{}

themes:setDefault改本地

设默认主题（传 null 清掉）

theme: 主题 id
accent: 可选，强调色

看调用示例

POST /v1/call/themes:setDefault
{
  "theme": "business"
}

themes:match改本地花云点

按这篇内容推荐一个排版主题

text: 正文
title: 可选
contentId: 可选

看调用示例

POST /v1/call/themes:match
{
  "text": "正文",
  "title": "标题"
}

themes:render改本地

Markdown 渲染成带样式的公众号 HTML

markdown: 正文
themeId: 可选，默认 business
accent: 可选
darkFriendly: 可选
layout: 可选

看调用示例

POST /v1/call/themes:render
{
  "markdown": "# 标题\n\n正文",
  "themeId": "business"
}

视频 `video:`

口播精剪、AI 成片、平台版本、切片、剪映导出、爆款结构

video:transcribe改本地花云点

口播录像 → 转写 + 精剪 + 包装 + 各平台版本（后台任务，用 video:job 查进度）

contentId: 内容 id
assetId: 录像素材 id（os:asset:add 加的 source_video）
aspect: 可选，9:16 / 16:9 / 1:1
fit: 可选，横拍出竖版：crop 跟人裁 / blur 模糊铺底 / frame 小人像
talkingHead: 可选，{ speed, polish, bgm, look: classic|glass, layout: overlay|split, captions: poster|box, hook, title }，不填画风版式字幕就按内容自动挑

看调用示例

POST /v1/call/video:transcribe
{
  "contentId": "content_xxx",
  "assetId": "asset_xxx",
  "aspect": "9:16",
  "talkingHead": {
    "polish": true,
    "look": "glass",
    "layout": "split",
    "captions": "box"
  }
}

video:activeJobs改本地

所有内容里还在跑的视频任务（精剪、重剪、合成、导出），带内容标题

video:recut改本地花云点

按转写稿的勾选重剪（不再转写）。不传 segments 沿用上次的勾选

contentId: 内容 id
segments: 可选，转写稿每段 { drop, clean? }，条数要和原转写一致
phrases: 可选，逐句精修：按转写稿 phrases 下标对齐的 { keep?, text?, startMs?, endMs? } 或 null（没动）；起止只能挪 1.5 秒以内，改过的句子 AI 不再改
talkingHead: 可选，同 video:transcribe
platforms: 可选

看调用示例

POST /v1/call/video:recut
{
  "contentId": "content_xxx",
  "talkingHead": {
    "layout": "split"
  }
}

video:plan改本地花云点

口播稿 / 母稿 → AI 成片分镜

contentId: 内容 id
script: 可选，口播稿
durationSec: 可选，目标秒数

看调用示例

POST /v1/call/video:plan
{
  "contentId": "content_xxx"
}

video:compose改本地花云点

AI 成片（后台任务）。style：motion / keynote / swiss / blueprint / sketch

contentId: 内容 id
scenes: 分镜（video:plan 的结果）
aspect: 可选
style: 可选，画风
voiceId: 可选，配音音色
bgm: 可选

看调用示例

POST /v1/call/video:compose
{
  "contentId": "content_xxx",
  "scenes": [
    {
      "id": "s1",
      "line": "这一场的口播",
      "keywords": [
        "关键词"
      ]
    }
  ],
  "aspect": "9:16",
  "style": "keynote"
}

video:job只读

视频后台任务进度和结果（成片路径、成片体检、没按计划做的地方）

jobId: 任务 id

看调用示例

POST /v1/call/video:job
{
  "jobId": "vjob_xxx"
}

video:jobs只读

某篇内容的视频任务列表（最新在前）

contentId: 内容 id
limit: 可选

看调用示例

POST /v1/call/video:jobs
{
  "contentId": "content_xxx",
  "limit": 5
}

video:cancel改本地

取消一个视频后台任务

jobId: 任务 id

看调用示例

POST /v1/call/video:cancel
{
  "jobId": "vjob_xxx"
}

video:variants改本地花云点

从主片出各平台版本（比例、时长、封面），后台任务

contentId: 内容 id
platforms: 可选，平台 id 列表
draftIds: 可选

看调用示例

POST /v1/call/video:variants
{
  "contentId": "content_xxx",
  "platforms": [
    "douyin",
    "video_wechat",
    "bilibili"
  ]
}

video:cutMoments改本地花云点

长视频挑出值得单独发的片段（后台任务，会花云点）

contentId: 内容 id

看调用示例

POST /v1/call/video:cutMoments
{
  "contentId": "content_xxx"
}

video:clipToContent改本地

把一个切片变成一篇独立内容（带平台稿）

contentId: 原内容 id
clipAssetId: 切片素材 id
platforms: 可选

看调用示例

POST /v1/call/video:clipToContent
{
  "contentId": "content_xxx",
  "clipAssetId": "asset_xxx"
}

video:exportJianying改本地

导出剪映专业版草稿（人像、画中画、标题、字幕、配乐分轨）

contentId: 内容 id
videoPath: 可选，指定哪个成片

返回 { name, draftDir }

看调用示例

POST /v1/call/video:exportJianying
{
  "contentId": "content_xxx"
}

video:joinSources改本地

把几段录像按文件名顺序接成一条原片（多段录制时用）

contentId: 内容 id
paths: 至少两个本地视频路径

看调用示例

POST /v1/call/video:joinSources
{
  "contentId": "content_xxx",
  "paths": [
    "D:/录像/1.mp4",
    "D:/录像/2.mp4"
  ]
}

video:previewProxy改本地

给浏览器放不了的视频做一个预览用的小文件

path: 本地视频路径

看调用示例

POST /v1/call/video:previewProxy
{
  "path": "D:/录像/口播.mov"
}

video:brollList只读

这篇内容的画中画素材

contentId: 内容 id

看调用示例

POST /v1/call/video:brollList
{
  "contentId": "content_xxx"
}

video:brollAdd改本地

给口播加画中画素材（本地图片 / 录屏）

contentId: 内容 id
paths: 本地文件路径

看调用示例

POST /v1/call/video:brollAdd
{
  "contentId": "content_xxx",
  "paths": [
    "D:/截图/demo.png"
  ]
}

video:interviewPlan改本地花云点

AI 访谈视频：按话题和嘉宾出采访提纲（会花云点）

contentId: 内容 id
topic: 话题
guest: 嘉宾
guestBio: 可选
count: 可选，几个问题

看调用示例

POST /v1/call/video:interviewPlan
{
  "contentId": "content_xxx",
  "topic": "一人公司怎么起步",
  "guest": "孟健"
}

video:interviewSave改本地

保存（改过的）采访提纲

contentId: 内容 id
plan: { questions: [...] }

看调用示例

POST /v1/call/video:interviewSave
{
  "contentId": "content_xxx",
  "plan": {
    "questions": [
      {
        "q": "第一个问题"
      }
    ]
  }
}

video:skeletons只读

拆过的爆款视频结构库

看调用示例

POST /v1/call/video:skeletons
{}

video:skeletonAnalyze改本地花云点

拆一条爆款视频的结构（给视频文件或粘贴文案，会花云点）

path: 可选，本地视频路径
text: 可选，文案（至少 20 字）
source: 可选，来源说明

看调用示例

POST /v1/call/video:skeletonAnalyze
{
  "text": "那条爆款视频的完整文案……",
  "source": "某博主"
}

video:skeletonDelete改本地

从爆款结构库删一条

id: 结构 id

看调用示例

POST /v1/call/video:skeletonDelete
{
  "id": "sk_xxx"
}

video:prefs只读

字流学到的剪辑默认选项（最近 5 次里 3 次一样的画风 / 版式 / 字幕 / 语速）

看调用示例

POST /v1/call/video:prefs
{}

video:voices只读

可用的配音音色

看调用示例

POST /v1/call/video:voices
{}

video:feedback改本地

对成片的一键反馈，记成以后的剪辑规则：busy / slow / fast / music / face / title

kind: 反馈类型

看调用示例

POST /v1/call/video:feedback
{
  "kind": "busy"
}

发布 `queue:`

送发布页（后台填稿）、发布看板、点发布、标记已发布

queue:pushDrafts改本地

把平台稿送到发布页：字流在后台把稿子填进各平台编辑器（不会公开），之后用 queue:submitFilled 点发布

contentId: 内容 id
draftIds: 可选，只送这几篇
mode: 可选，semi（默认，填好等你确认）
timing: 可选，now / best（挑这个平台读者最活跃的时间）

看调用示例

POST /v1/call/queue:pushDrafts
{
  "contentId": "content_xxx",
  "timing": "now"
}

queue:board只读

发布看板：每个平台任务的状态（填稿中 / 已填好等你确认 / 已发布 / 失败）

看调用示例

POST /v1/call/queue:board
{}

queue:list只读

发布任务列表

status: 可选，pending / running / awaiting_confirm / success / failed / cancelled

看调用示例

POST /v1/call/queue:list
{
  "status": "awaiting_confirm"
}

queue:listEvidence只读

一条发布任务的截图记录（填稿前后、出错现场）

jobId: 任务 id

看调用示例

POST /v1/call/queue:listEvidence
{
  "jobId": "job_xxx"
}

queue:sendDiagnostics不开放

把失败任务的报错、填稿记录和截图发给字流（用户自己在发布页点）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

queue:submitFilled会公开

【会公开】在已经填好的窗口里点「发布」。要设置里允许，并带 confirm: true

jobIds: 任务 id 列表
confirm: 必须 true

看调用示例

POST /v1/call/queue:submitFilled
{
  "jobIds": [
    "job_xxx"
  ],
  "confirm": true
}

queue:confirm改本地

你在平台上手动发完后，标记这条任务已发布

jobId: 任务 id
resultUrl: 可选，作品链接

看调用示例

POST /v1/call/queue:confirm
{
  "jobId": "job_xxx",
  "resultUrl": "https://..."
}

queue:retry改本地

失败的任务重试

jobId: 任务 id

看调用示例

POST /v1/call/queue:retry
{
  "jobId": "job_xxx"
}

queue:resend改本地

已发过的再送一次（比如平台删了要重发）

jobId: 任务 id

看调用示例

POST /v1/call/queue:resend
{
  "jobId": "job_xxx"
}

queue:cancel改本地

取消一个还没发的任务

jobId: 任务 id

看调用示例

POST /v1/call/queue:cancel
{
  "jobId": "job_xxx"
}

queue:remove改本地

从看板删掉一条任务记录

jobId: 任务 id

看调用示例

POST /v1/call/queue:remove
{
  "jobId": "job_xxx"
}

queue:trial改本地

先发给某个账号分组试水

jobId: 任务 id
groupId: 账号分组 id

看调用示例

POST /v1/call/queue:trial
{
  "jobId": "job_xxx",
  "groupId": "grp_xxx"
}

queue:refillClosed改本地

字流重启后填稿窗口没了：已填好待发的任务全部在后台重填

firstJobId: 可选，填好后先叫到前台的那条

看调用示例

POST /v1/call/queue:refillClosed
{}

queue:release会公开

【会公开】放行一条被挡住的定时任务，到点就发

jobId: 任务 id
confirm: 必须 true

看调用示例

POST /v1/call/queue:release
{
  "jobId": "job_xxx",
  "confirm": true
}

queue:publishDraft会公开

【会公开】轻舟（shipsolo）：把填好的草稿直接改成发布

jobId: 任务 id
confirm: 必须 true

看调用示例

POST /v1/call/queue:publishDraft
{
  "jobId": "job_xxx",
  "confirm": true
}

queue:openEditor不开放

把发布窗口叫到前台。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

queue:openEvidence不开放

打开截图目录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

发布预设 `preset:`

每个平台的开头结尾和默认发布选项

preset:list只读

发布预设（每个平台的开头结尾、默认发布选项）

platformId: 可选，只看某个平台

看调用示例

POST /v1/call/preset:list
{
  "platformId": "wechat_mp"
}

preset:get只读

取一套发布预设

id: 预设 id

看调用示例

POST /v1/call/preset:get
{
  "id": "preset_xxx"
}

preset:default只读

某个平台写稿时自动套用的那套

platformId: 平台 id

看调用示例

POST /v1/call/preset:default
{
  "platformId": "wechat_mp"
}

preset:save改本地

新建或修改一套发布预设

preset: { id?, name, platformId, headerContent?, footerContent?, isDefault?, extra? }

看调用示例

POST /v1/call/preset:save
{
  "preset": {
    "name": "日常",
    "platformId": "zhihu",
    "footerContent": "觉得有用点个赞"
  }
}

preset:remove改本地

删一套发布预设

id: 预设 id

看调用示例

POST /v1/call/preset:remove
{
  "id": "preset_xxx"
}

preset:featuredArticles只读

公众号「往期精选」要插的最近几篇已发文章

platformId: wechat_mp
count: 可选，1–20
excludeTitle: 可选，排除这篇

看调用示例

POST /v1/call/preset:featuredArticles
{
  "platformId": "wechat_mp",
  "count": 10
}

发布调试 `publish:`

填表演练（只截图不提交）

publish:dryRun改本地

填表演练：按平台稿跑一遍填稿流程并截图，绝不提交、不存草稿（排查某个平台填不进去时用）

draftId: 平台稿 id（或直接给 platform + article）
accountId: 可选

看调用示例

POST /v1/call/publish:dryRun
{
  "draftId": "draft_xxx"
}

评论与私信 `operation:`

各平台的评论私信收件箱、草拟回复、发回复

operation:inbox只读

各平台的评论和私信

status: 可选，unread / pending_reply / replied / ignored

看调用示例

POST /v1/call/operation:inbox
{
  "status": "unread"
}

operation:draftReply改本地花云点

按你的口吻草拟一条回复（不发，会花云点）

interactionId: 互动 id

看调用示例

POST /v1/call/operation:draftReply
{
  "interactionId": "int_xxx"
}

operation:confirmReply会公开

【会公开】把草拟的回复发出去

interactionId: 互动 id
confirm: 必须 true

看调用示例

POST /v1/call/operation:confirmReply
{
  "interactionId": "int_xxx",
  "confirm": true
}

operation:setStatus改本地

改一条评论 / 私信的状态

interactionId: 互动 id
status: unread / pending_reply / replied / ignored

看调用示例

POST /v1/call/operation:setStatus
{
  "interactionId": "int_xxx",
  "status": "ignored"
}

operation:setStatusMany改本地

批量改状态

interactionIds: 互动 id 列表
status: 同上

看调用示例

POST /v1/call/operation:setStatusMany
{
  "interactionIds": [
    "int_1",
    "int_2"
  ],
  "status": "replied"
}

operation:replyCapabilities只读

哪些平台能从字流直接发回复（其余要复制去平台回）

看调用示例

POST /v1/call/operation:replyCapabilities
{}

operation:openTarget不开放

打开评论原文页面。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

评论洞察 `commentInsights:`

评论的情绪占比、反复主题、读者提问，一键转选题

commentInsights:overview改本地

评论洞察：最近 N 天评论的情绪占比、反复出现的主题、读者提问（不花云点）

days: 天数，默认 30

看调用示例

POST /v1/call/commentInsights:overview
{
  "days": 30
}

commentInsights:summarize改本地花云点

让 AI 归纳最近 N 天的评论：读者在意什么、在问什么（会花云点）

days: 天数，默认 30

看调用示例

POST /v1/call/commentInsights:summarize
{
  "days": 30
}

commentInsights:toTopic改本地

把一条读者提问转成选题，进选题库

item: 评论洞察里的一条提问

看调用示例

POST /v1/call/commentInsights:toTopic
{
  "item": {
    "text": "这个怎么收费？"
  }
}

AI 实测 `operator:`

AI 在网页或本机软件里实操一遍、每步截图，再写成教程

operator:start不开放

让 AI 操作员开始在网页或本机桌面上实操（会动鼠标键盘）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

operator:answer不开放

替 AI 操作员回答问题、批准有后果的动作。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

operator:stop改本地

停止正在跑的 AI 实测

runId: 运行 id

看调用示例

POST /v1/call/operator:stop
{
  "runId": "op_xxx"
}

operator:runs改本地

最近的 AI 实测：目标、状态、每一步说明和截图路径

看调用示例

POST /v1/call/operator:runs
{}

operator:tutorial改本地花云点

用一次 AI 实测的截图写成教程母稿（会花云点）

runId: 运行 id
keep: 要用的步骤编号数组（可选）
firsthand: 作者自己的一句话（可选）

看调用示例

POST /v1/call/operator:tutorial
{
  "runId": "op_xxx",
  "keep": [
    1,
    3,
    5
  ]
}

待指路评论 `lead:`

求资料的评论：按内容的领取关键词回复

lead:pendingComments只读

求资料 / 问链接的评论（待指路），每条带好了按这篇关键词写的回复

看调用示例

POST /v1/call/lead:pendingComments
{}

lead:sendReplies会公开

【会公开】把待指路的回复发出去（每平台每天 20 条上限，间隔 8–20 秒）

ids: 评论 id 列表（最多 60）
confirm: 必须 true

看调用示例

POST /v1/call/lead:sendReplies
{
  "ids": [
    "int_xxx"
  ],
  "confirm": true
}

领资料钩子 `leadMagnet:`

每篇的领取关键词、完整版 PDF、公众号关键词自动回复

leadMagnet:get只读

这篇的领资料钩子（关键词、资料标题、要点、PDF、公众号规则同步了没有）和回复原文

contentId: 内容 id

看调用示例

POST /v1/call/leadMagnet:get
{
  "contentId": "content_xxx"
}

leadMagnet:generate改本地花云点

给这篇生成领取关键词和资料要点（会花云点）

contentId: 内容 id

看调用示例

POST /v1/call/leadMagnet:generate
{
  "contentId": "content_xxx"
}

leadMagnet:save改本地

保存改过的领资料钩子

contentId: 内容 id
magnet: { keyword, title, lines, ... }

看调用示例

POST /v1/call/leadMagnet:save
{
  "contentId": "content_xxx",
  "magnet": {
    "keyword": "重构清单",
    "title": "重构清单",
    "lines": [
      "第一条"
    ]
  }
}

leadMagnet:makePdf改本地花云点

生成完整版资料 PDF（会花云点）

contentId: 内容 id

看调用示例

POST /v1/call/leadMagnet:makePdf
{
  "contentId": "content_xxx"
}

leadMagnet:autoPrepare改本地花云点

一条龙：没关键词就生成 → 没 PDF 就做 → 传云端拿下载链接 → 在公众号建关键词规则（做过的步骤跳过）

contentId: 内容 id

看调用示例

POST /v1/call/leadMagnet:autoPrepare
{
  "contentId": "content_xxx"
}

leadMagnet:syncMp会公开

【会公开】在你的公众号后台建这篇的关键词自动回复规则

contentId: 内容 id
confirm: 必须 true

看调用示例

POST /v1/call/leadMagnet:syncMp
{
  "contentId": "content_xxx",
  "confirm": true
}

leadMagnet:addKeywordVariants会公开

【会公开】给字流建过的公众号关键词规则补写法（大小写、中英之间带空格），回复内容不动

only: 可选，只处理这些规则名
confirm: 必须 true

看调用示例

POST /v1/call/leadMagnet:addKeywordVariants
{
  "confirm": true
}

leadMagnet:fixMpRules会公开

【会公开】修字流建过的公众号规则：补写法、补名片图、资料文案换成带下载链接的

only: 可选，规则名
confirm: 必须 true

看调用示例

POST /v1/call/leadMagnet:fixMpRules
{
  "confirm": true
}

leadMagnet:patchMpRules会公开

【会公开】给公众号已有的关键词回复补（或按新见面礼重写）「加个人微信」那一句

only: 可选
rewrite: 可选，true 重写已有那句
confirm: 必须 true

看调用示例

POST /v1/call/leadMagnet:patchMpRules
{
  "confirm": true
}

leadMagnet:addCardToMpRules会公开

【会公开】给公众号关键词规则挂上微信名片图

only: 可选
skip: 可选，跳过的规则（如合作方的）
confirm: 必须 true

看调用示例

POST /v1/call/leadMagnet:addCardToMpRules
{
  "confirm": true
}

leadMagnet:showPdf不开放

在文件夹里显示 PDF。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

引流置顶评论 `leadPin:`

视频发布后自动发指路评论并置顶

leadPin:run会公开

【会公开】对刚发布的视频补发指路评论并置顶（B 站、视频号能置顶；抖音快手只能在 App 里置顶）

jobId: 可选，只处理这条发布任务
dryRun: 可选，true 只演练不发
confirm: 必须 true

看调用示例

POST /v1/call/leadPin:run
{
  "jobId": "job_xxx",
  "dryRun": true,
  "confirm": true
}

leadPin:status只读

各条视频的置顶评论状态

看调用示例

POST /v1/call/leadPin:status
{}

leadPin:smsPending改本地

抖音发评论正在等短信验证码吗（有就返回是哪条）

看调用示例

POST /v1/call/leadPin:smsPending
{}

leadPin:smsCode改本地

把抖音发来的短信验证码交给字流（4 分钟内有效）

code: 验证码

看调用示例

POST /v1/call/leadPin:smsCode
{
  "code": "123456"
}

发出去之后 `aftercare:`

72 小时内每篇的下一步：置顶评论、加热、追发

aftercare:list只读

72 小时内发出去的每篇的下一步：要你亲手发的置顶评论、和平时比、爆了怎么加热 / 追发 / 写续集

看调用示例

POST /v1/call/aftercare:list
{}

aftercare:done改本地

标记一项「发出去之后」的待办做完了

key: 待办的 key（pin: 或 post: 开头）

看调用示例

POST /v1/call/aftercare:done
{
  "key": "pin:job_xxx"
}

数据 `analytics:`

各平台粉丝、阅读播放、互动的采集和看板

analytics:reply会公开

【会公开】直接回复一条评论（旧通道，一般用 operation:confirmReply）

interactionId: 互动 id
replyText: 回复内容
confirm: 必须 true

看调用示例

POST /v1/call/analytics:reply
{
  "interactionId": "int_xxx",
  "replyText": "谢谢！",
  "confirm": true
}

analytics:board只读

数据看板（各平台阅读 / 播放 / 互动 / 涨粉），rangeDays 只能 7 / 30 / 90

rangeDays: 7 / 30 / 90

看调用示例

POST /v1/call/analytics:board
{
  "rangeDays": 30
}

analytics:list只读

各账号的数据快照和互动原始数据

看调用示例

POST /v1/call/analytics:list
{}

analytics:history只读

粉丝、阅读等的历史曲线

看调用示例

POST /v1/call/analytics:history
{}

analytics:status只读

数据同步状态（各账号上次采集时间、有没有失败）

看调用示例

POST /v1/call/analytics:status
{}

analytics:sync改本地

马上采一轮数据（不传就全部账号）

accountIds: 可选

看调用示例

POST /v1/call/analytics:sync
{}

复盘 `review:`

单篇表现、周报、经验、投流记录、合作数据卡

review:byContent只读

每篇内容在各平台的表现和「比平时」倍数

看调用示例

POST /v1/call/review:byContent
{}

review:byAccount只读

每个账号的表现汇总

看调用示例

POST /v1/call/review:byAccount
{}

review:byTopicAll只读

每个选题写出来的内容表现汇总

看调用示例

POST /v1/call/review:byTopicAll
{}

review:contentMetrics只读

各账号抓到的单篇数据（每个标题取最新一份）

看调用示例

POST /v1/call/review:contentMetrics
{}

review:weeklyReport只读花云点

周报：哪些跑赢、哪些停掉、下周试什么（会花云点）

sinceIso: 可选，起始时间

看调用示例

POST /v1/call/review:weeklyReport
{}

review:lastReport只读

上一份周报

看调用示例

POST /v1/call/review:lastReport
{}

review:learnings只读

复盘学到的经验（正在用在选题和写稿里的 / 停用的）

看调用示例

POST /v1/call/review:learnings
{}

review:setLearning改本地

停用或恢复一条经验

id: 经验 id
status: active / muted

看调用示例

POST /v1/call/review:setLearning
{
  "id": "lrn_xxx",
  "status": "muted"
}

review:boosts只读

投流记录和算出来的单粉成本

看调用示例

POST /v1/call/review:boosts
{}

review:recordBoost改本地

记一笔投流（48 小时后自动算回报）

platformId: 平台 id
title: 作品标题
amount: 投了多少元
accountId: 可选
contentId: 可选

看调用示例

POST /v1/call/review:recordBoost
{
  "platformId": "douyin",
  "title": "作品标题",
  "amount": 100
}

review:removeBoost改本地

删一笔投流记录

id: 记录 id

看调用示例

POST /v1/call/review:removeBoost
{
  "id": "boost_xxx"
}

review:leads只读

每篇内容带来了多少人领资料

看调用示例

POST /v1/call/review:leads
{}

review:mediaKit只读

生成合作数据卡（一张 3:4 的图，发给品牌方）

返回 { path }

看调用示例

POST /v1/call/review:mediaKit
{}

review:showFile不开放

在文件夹里显示。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

IP 深度复盘 `ipReview:`

每周一份：定位、信任、各平台角色、读者原话、商业价值、下周计划

ipReview:last只读

最近一份 IP 深度复盘（定位、信任、各平台角色、读者原话、商业价值、下周计划）

看调用示例

POST /v1/call/ipReview:last
{}

ipReview:history只读

历次 IP 深度复盘

看调用示例

POST /v1/call/ipReview:history
{}

ipReview:run改本地花云点

现在做一份 IP 深度复盘（约 2–3 分钟，会花云点）

看调用示例

POST /v1/call/ipReview:run
{}

成长记录 `growth:`

字流自己学到的东西，每条可撤销

growth:list只读

字流自己学到的东西（个人资产、写法、剪辑偏好、复盘经验），每条可撤销

days: 可选，近几天，默认 7

看调用示例

POST /v1/call/growth:list
{}

growth:undo改本地

撤销一条成长记录（字流学错了）

id: 记录 id

看调用示例

POST /v1/call/growth:undo
{
  "id": "gr_xxx"
}

定位 `positioning:`

定位档案、个人资产学习、对标作者

positioning:get只读

定位档案（赛道、内容支柱、个人资产、对标）

看调用示例

POST /v1/call/positioning:get
{}

positioning:save改本地

保存某个账号的定位档案

positioning: { accountId, ... }

看调用示例

POST /v1/call/positioning:save
{
  "positioning": {
    "accountId": "acc_xxx",
    "keywords": [
      "AI 编程"
    ]
  }
}

positioning:synthesize改本地花云点

按这个账号发过的内容自动总结定位（会花云点）

accountId: 账号 id

看调用示例

POST /v1/call/positioning:synthesize
{
  "accountId": "acc_xxx"
}

positioning:tier:save改本地

改账号分档：main 主号 / derived 衍生号 / auto 全自动分发号

accountId: 账号 id
tier: main / derived / auto

看调用示例

POST /v1/call/positioning:tier:save
{
  "accountId": "acc_xxx",
  "tier": "auto"
}

positioning:suggestCompetitors改本地花云点

按定位关键词在掘金 / B 站找对标作者（会花云点）

accountId: 账号 id
keywords: 可选，关键词

看调用示例

POST /v1/call/positioning:suggestCompetitors
{
  "accountId": "acc_xxx",
  "keywords": [
    "Claude Code"
  ]
}

positioning:learnAssets改本地花云点

从你发过的内容里学个人资产（经历、数字、金句）

full: 可选，true 全量重学

看调用示例

POST /v1/call/positioning:learnAssets
{}

positioning:learnState只读

个人资产学习的进度

看调用示例

POST /v1/call/positioning:learnState
{}

人设 `persona:`

人设卡：我是谁、写给谁、什么口吻

persona:list只读

人设卡（我是谁、写给谁看、口吻）

看调用示例

POST /v1/call/persona:list
{}

persona:save改本地

新建或修改人设卡

persona: { id?, name, ... }

看调用示例

POST /v1/call/persona:save
{
  "persona": {
    "name": "孟健",
    "audience": "独立开发者",
    "tone": "冷静、讲真实数据"
  }
}

persona:remove改本地

删一张人设卡

id: 人设 id

看调用示例

POST /v1/call/persona:remove
{
  "id": "persona_xxx"
}

persona:synthesize改本地花云点

按账号发过的内容合成人设卡（会花云点）

accountIds: 可选

看调用示例

POST /v1/call/persona:synthesize
{}

新人开张 `onboarding:`

一句话生成人设、定位、推荐平台和起步选题

onboarding:profileDraft改本地花云点

新人开张：一句话「你是谁」→ 人设 + 定位 + 推荐平台 + 3 个起步选题（草稿，不落库）

text: 一句话介绍自己

看调用示例

POST /v1/call/onboarding:profileDraft
{
  "text": "前大厂技术 Leader，现在全职做一人公司，写 AI 编程"
}

onboarding:profileApply改本地

确认 onboarding:profileDraft 的结果并落库

profile: profileDraft 返回的对象

看调用示例

POST /v1/call/onboarding:profileApply
{
  "profile": {}
}

写作风格与素材 `kit:`

写作规则、金句、素材、流程模板

kit:list只读

写作风格与素材。kind：style_rule 写作规则 / quote 金句 / material 素材 / workflow 流程模板

kind: 可选
personaId: 可选

看调用示例

POST /v1/call/kit:list
{
  "kind": "quote"
}

kit:search只读

搜写作素材 / 金句

keyword: 关键词
kind: 可选

看调用示例

POST /v1/call/kit:search
{
  "keyword": "一人公司"
}

kit:save改本地

新建或修改一条写作规则 / 金句 / 素材

asset: { id?, kind, title?, body, personaId? }

看调用示例

POST /v1/call/kit:save
{
  "asset": {
    "kind": "quote",
    "body": "能用钱解决的都不是问题"
  }
}

kit:remove改本地

删一条写作规则 / 金句 / 素材

id: 条目 id

看调用示例

POST /v1/call/kit:remove
{
  "id": "kit_xxx"
}

kit:context只读

写某个平台时会注入的写作风格和素材（预览）

personaId: 可选
platformId: 可选
kind: 可选
keywords: 可选

看调用示例

POST /v1/call/kit:context
{
  "platformId": "wechat_mp"
}

kit:distill改本地花云点

从几篇文章里提炼写作规则和金句（会花云点），结果用 kit:saveDistilled 保存

contentIds: 可选，最多 5 篇内容
texts: 可选，直接给文本
personaId: 可选

看调用示例

POST /v1/call/kit:distill
{
  "contentIds": [
    "content_xxx"
  ]
}

kit:saveDistilled改本地

保存提炼出的写作规则和金句

items: kit:distill 返回的条目

看调用示例

POST /v1/call/kit:saveDistilled
{
  "items": []
}

kit:seedQuotes改本地

一键加入预置名人名言（出处明确的），已有的跳过

看调用示例

POST /v1/call/kit:seedQuotes
{}

素材库 `kb:`

素材站点、收藏的网页、全文搜索

kb:search只读

搜你的素材库 / 知识库

q: 关键词

看调用示例

POST /v1/call/kb:search
{
  "q": "Claude Code"
}

kb:sites:list只读

素材站点（字流会去这些网站找资料）

看调用示例

POST /v1/call/kb:sites:list
{}

kb:sites:save改本地

新增或修改素材站点

site: { id?, name, baseUrl, loginUrl?, searchUrl? }

看调用示例

POST /v1/call/kb:sites:save
{
  "site": {
    "name": "少数派",
    "baseUrl": "https://sspai.com"
  }
}

kb:sites:remove改本地

删素材站点（连同它的登录会话）

id: 站点 id

看调用示例

POST /v1/call/kb:sites:remove
{
  "id": "site_xxx"
}

kb:sites:check改本地

检查素材站点能不能打开、要不要登录

id: 站点 id

看调用示例

POST /v1/call/kb:sites:check
{
  "id": "site_xxx"
}

kb:docs:list只读

某个站点收进来的网页

siteId: 站点 id

看调用示例

POST /v1/call/kb:docs:list
{
  "siteId": "site_xxx"
}

kb:docs:remove改本地

删一条收藏的网页

id: 文档 id

看调用示例

POST /v1/call/kb:docs:remove
{
  "id": "doc_xxx"
}

kb:sites:loginDone不开放

素材站点登录完成。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

腾讯 ima `ima:`

把内容存进 ima 知识库

ima:get只读

腾讯 ima 连接状态（密钥打码）

看调用示例

POST /v1/call/ima:get
{}

ima:knowledgeBases只读

能往里加内容的 ima 知识库

看调用示例

POST /v1/call/ima:knowledgeBases
{}

ima:saveNote改本地

把一篇内容存进 ima 知识库

contentId: 内容 id

看调用示例

POST /v1/call/ima:saveNote
{
  "contentId": "content_xxx"
}

ima:save不开放

保存 ima 密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ima:clear不开放

清除 ima 密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

助手 `copilot:`

带你的定位、内容和数据上下文的对话

copilot:chat改本地花云点

问字流助手（带你的定位、内容和数据上下文，会花云点）

messages: 对话 [{ role, content }]
context: 可选，当前页面上下文
research: 可选，true 先联网

看调用示例

POST /v1/call/copilot:chat
{
  "messages": [
    {
      "role": "user",
      "content": "这周该写什么？"
    }
  ]
}

copilot:cancel改本地

停掉一次正在进行的助手对话

requestId: 请求 id

看调用示例

POST /v1/call/copilot:cancel
{
  "requestId": "req_xxx"
}

copilot:chatStream不开放花云点

流式对话（Agent 用 copilot:chat）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

私域 `privateDomain:`

个人微信、公众号名、见面礼

privateDomain:get只读

私域设置：个人微信、公众号名、群、见面礼

看调用示例

POST /v1/call/privateDomain:get
{}

privateDomain:save改本地

改私域设置

settings: { wechatId?, mpName?, groupName?, welcomeGift? }

看调用示例

POST /v1/call/privateDomain:save
{
  "settings": {
    "mpName": "孟健AI编程"
  }
}

账号矩阵 `matrix:`

账号列表、分组、健康度

matrix:accounts只读

全部账号（矩阵视图）

看调用示例

POST /v1/call/matrix:accounts
{}

matrix:grouped只读

按分组排好的账号

看调用示例

POST /v1/call/matrix:grouped
{}

matrix:groups只读

账号分组

看调用示例

POST /v1/call/matrix:groups
{}

matrix:createGroup改本地

新建账号分组

name: 分组名
color: 可选

看调用示例

POST /v1/call/matrix:createGroup
{
  "name": "主号"
}

matrix:assignGroup改本地

把账号放进某个分组（不传 groupId 就移出）

accountId: 账号 id
groupId: 可选

看调用示例

POST /v1/call/matrix:assignGroup
{
  "accountId": "acc_xxx",
  "groupId": "grp_xxx"
}

matrix:health只读

账号健康度：哪些掉登录、哪些采集失败

看调用示例

POST /v1/call/matrix:health
{}

账号 `account:`

已绑定的平台账号

account:list只读

已绑定的平台账号（含登录状态）

看调用示例

POST /v1/call/account:list
{}

account:save不开放

新增 / 修改平台账号。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

account:remove不开放

删除平台账号。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

account:logout不开放

退出某个平台账号的登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

平台适配器 `adapter:`

平台能力、登录状态检查

adapter:publish会公开

【会公开】直接调某个平台适配器发一篇（绕过发布队列，一般用 queue:pushDrafts）

platform: 平台 id
article: 文章对象
confirm: 必须 true

看调用示例

POST /v1/call/adapter:publish
{
  "platform": "zhihu",
  "article": {
    "title": "标题",
    "content": "正文"
  },
  "confirm": true
}

adapter:list只读

各平台能做什么（发布、采集、回复）

看调用示例

POST /v1/call/adapter:list
{}

adapter:checkAuth只读

检查某个平台账号还登录着没有

platform: 平台 id
accountId: 可选

看调用示例

POST /v1/call/adapter:checkAuth
{
  "platform": "zhihu"
}

adapter:configure不开放

改平台适配器配置。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

adapter:loginAt不开放

在指定网址登录平台。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

知识星球 `zsxq:`

能发的星球

zsxq:groups只读

能发的知识星球（你是星主 / 管理员的）和上次选的

看调用示例

POST /v1/call/zsxq:groups
{}

zsxq:setLastGroups改本地

记住这次选的星球（新稿默认勾上）

args: [星球 id 列表]（老式参数，放在 args 里）

看调用示例

POST /v1/call/zsxq:setLastGroups
{
  "args": [
    [
      "123",
      "456"
    ]
  ]
}

小红书交接 `handoff:`

用你自己的 Chrome 打开小红书发布页并自动填好

handoff:xhs会公开

【会公开】小红书：把这篇备好，用你的默认浏览器（Chrome）打开发布页，插件自动填好，你自己点发布

draftId: 小红书稿 id
open: 可选，true 直接打开浏览器
confirm: 必须 true

看调用示例

POST /v1/call/handoff:xhs
{
  "draftId": "draft_xxx",
  "open": true,
  "confirm": true
}

内容日历 `calendar:`

已发布和定时待发的内容按天排

calendar:range只读

内容日历：已发布和定时待发的内容按天排，今天以后带推荐选题

from: yyyy-mm-dd
to: yyyy-mm-dd

看调用示例

POST /v1/call/calendar:range
{
  "from": "2026-10-01",
  "to": "2026-10-31"
}

海外平台语言 `contentLang:`

X、Threads、YouTube 等出中文还是英文

contentLang:get只读

海外平台各出中文还是英文

看调用示例

POST /v1/call/contentLang:get
{}

contentLang:set改本地

设某个海外平台的输出语言

platformId: 平台 id
lang: zh / en

看调用示例

POST /v1/call/contentLang:set
{
  "platformId": "x",
  "lang": "en"
}

AI 模型 `ai:`

模型来源、默认模型、花费估算（密钥相关的不开放）

ai:status只读

AI 状态：用字流 AI 还是自己的密钥、默认模型、通不通

看调用示例

POST /v1/call/ai:status
{}

ai:providers只读

能用的国产模型供应商

看调用示例

POST /v1/call/ai:providers
{}

ai:listModels只读

某个供应商的实时模型列表

provider: 可选
source: 可选，byok / platform

看调用示例

POST /v1/call/ai:listModels
{
  "provider": "deepseek"
}

ai:setSource改本地

切换用字流 AI（platform）还是自己的密钥（byok）

source: platform / byok

看调用示例

POST /v1/call/ai:setSource
{
  "source": "platform"
}

ai:setDefaultProvider改本地

自有密钥时默认用哪家（只支持国产）

provider: 供应商 id

看调用示例

POST /v1/call/ai:setDefaultProvider
{
  "provider": "deepseek"
}

ai:setModel改本地

某家供应商用哪个模型

provider: 供应商 id
model: 模型名

看调用示例

POST /v1/call/ai:setModel
{
  "provider": "deepseek",
  "model": "deepseek-chat"
}

ai:setPlatformModel改本地

字流 AI 用哪档模型

model: 模型档位

看调用示例

POST /v1/call/ai:setPlatformModel
{
  "model": "standard"
}

ai:test改本地

试一句，看 AI 通不通

provider: 可选
source: 可选

看调用示例

POST /v1/call/ai:test
{}

ai:costReport只读

自有密钥的花费估算（字流 AI 走云点，不在这里）

sinceIso: 可选，默认近 30 天

看调用示例

POST /v1/call/ai:costReport
{}

ai:pointEstimates只读

各功能大概花多少云点（写一篇、生一张图、转写 10 分钟……）

看调用示例

POST /v1/call/ai:pointEstimates
{}

ai:setKey不开放

保存模型密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:importCredential不开放

导入本机 CLI 的登录态。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:importLocalKey不开放

导入本机扫到的密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:detectLocalKeys不开放

扫描本机的模型密钥。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:oauth:start不开放

模型供应商登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:oauth:poll不开放

模型供应商登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:oauth:submitCode不开放

模型供应商登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:oauth:logout不开放

模型供应商退出。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:setCustomEndpoint不开放

自定义模型网关。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

ai:setPlatformAuth不开放

字流 AI 的令牌。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

配置 `config:`

不含密钥的配置项

config:get只读

不含密钥的配置：主题、语言、自动更新、选题雷达（每天几点出选题、热榜 / RSS 来源、联网）、视频默认

看调用示例

POST /v1/call/config:get
{}

config:set改本地

改一项不含密钥的配置（key 见 config:get）

key: 配置项
value: 新值

看调用示例

POST /v1/call/config:set
{
  "key": "topics:dailyHour",
  "value": 8
}

套餐 `entitlements:`

当前套餐和云点

entitlements:get只读

当前套餐、能绑几个号、剩余云点、可用功能

看调用示例

POST /v1/call/entitlements:get
{}

entitlements:refresh改本地

从云端重新拉一次套餐

看调用示例

POST /v1/call/entitlements:refresh
{}

entitlements:refreshIfStale改本地

套餐超过 45 秒没更新才去云端拉（付款、加云点后切回来用），否则直接返回缓存

看调用示例

POST /v1/call/entitlements:refreshIfStale
{}

套餐 `billing:`

刷新套餐

billing:refresh改本地

刷新套餐（网站兑换或客服改了套餐后）

看调用示例

POST /v1/call/billing:refresh
{}

billing:redeem不开放

兑换码。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

字流账号 `cloud:`

登录状态、邀请有礼

cloud:status只读

字流账号登录了没有、是谁

看调用示例

POST /v1/call/cloud:status
{}

cloud:referral只读

我的邀请链接和邀请战绩

看调用示例

POST /v1/call/cloud:referral
{}

cloud:logout不开放

退出字流账号。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

cloud:connectToken不开放

用令牌连接字流账号。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

cloud:wechatLogin不开放

微信扫码登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

cloud:wechatStatus不开放

微信扫码登录状态。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

cloud:wechatCancel不开放

取消微信扫码登录。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

cloud:bindReferral不开放

补填邀请码。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

同步 `sync:`

稿件同步到网页版

sync:status只读

稿件同步到网页版的状态

看调用示例

POST /v1/call/sync:status
{}

sync:now改本地

马上同步一次稿件到网页版

看调用示例

POST /v1/call/sync:now
{}

平台门禁 `platform:`

哪些平台已开放

platform:gate只读

哪些平台已开放、哪些待开放

看调用示例

POST /v1/call/platform:gate
{}

应用 `app:`

版本信息

app:getInfo只读

字流版本、系统、设备编号

看调用示例

POST /v1/call/app:getInfo
{}

更新 `update:`

检查更新

update:status只读

更新状态（有没有新版本、下载到哪了）

看调用示例

POST /v1/call/update:status
{}

update:check改本地

检查一次更新

看调用示例

POST /v1/call/update:check
{}

update:install不开放

安装更新并重启。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

设置（不开放） `settings:`

含令牌和密钥

settings:get不开放

全部设置（含令牌）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

settings:set不开放

改全部设置。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

存储（不开放） `store:`

原始键值存储

store:get不开放

读原始存储。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

store:set不开放

写原始存储。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

浏览器（不开放） `browser:`

有头浏览器窗口

browser:launch不开放

打开浏览器窗口。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

browser:close不开放

关闭浏览器窗口。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

browser:screenshot不开放

浏览器窗口截图。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

文件对话框（不开放） `file:`

要人在电脑前选文件

file:selectVideo不开放

选视频文件的对话框。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

回复取证（不开放） `reply:`

打开截图

reply:openEvidence不开放

打开回复失败截图。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

AI Agent 设置（不开放） `agent:`

Agent 不能给自己开权限

agent:info不开放

AI Agent 设置页。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

agent:setAllowPublic不开放

允许 Agent 做会公开的操作（只能你在设置里点）。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

agent:resetToken不开放

重置本机接口令牌。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

agent:installSkills不开放

安装官方 skills。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

agent:connect不开放

一键接入 Agent 客户端。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

调试（不开放） `debug:`

内部调试

debug:dumpInteractionPage不开放

调试。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

debug:recentPosts不开放

调试。不开放给 Agent（涉及密钥、登录、付款，或要人在电脑前操作）

能力参考：308 个能力逐个说明

怎么读

全部能力

写稿 creation:

后台流水线 pipeline:

内容、平台稿与素材 os:

选题 topics:

联网检索 research:

配图与封面 media:

公众号排版 themes:

视频 video:

发布 queue:

发布预设 preset:

发布调试 publish:

评论与私信 operation:

评论洞察 commentInsights:

AI 实测 operator:

待指路评论 lead:

领资料钩子 leadMagnet:

引流置顶评论 leadPin:

发出去之后 aftercare:

数据 analytics:

复盘 review:

IP 深度复盘 ipReview:

成长记录 growth:

定位 positioning:

人设 persona:

新人开张 onboarding:

写作风格与素材 kit:

素材库 kb:

腾讯 ima ima:

助手 copilot:

私域 privateDomain:

账号矩阵 matrix:

账号 account:

平台适配器 adapter:

知识星球 zsxq:

小红书交接 handoff:

内容日历 calendar:

海外平台语言 contentLang:

AI 模型 ai:

配置 config:

套餐 entitlements:

套餐 billing:

字流账号 cloud:

同步 sync:

平台门禁 platform:

应用 app:

更新 update:

设置（不开放） settings:

存储（不开放） store:

浏览器（不开放） browser:

文件对话框（不开放） file:

回复取证（不开放） reply:

AI Agent 设置（不开放） agent:

调试（不开放） debug:

写稿 `creation:`

后台流水线 `pipeline:`

内容、平台稿与素材 `os:`

选题 `topics:`

联网检索 `research:`

配图与封面 `media:`

公众号排版 `themes:`

视频 `video:`

发布 `queue:`

发布预设 `preset:`

发布调试 `publish:`

评论与私信 `operation:`

评论洞察 `commentInsights:`

AI 实测 `operator:`

待指路评论 `lead:`

领资料钩子 `leadMagnet:`

引流置顶评论 `leadPin:`

发出去之后 `aftercare:`

数据 `analytics:`

复盘 `review:`

IP 深度复盘 `ipReview:`

成长记录 `growth:`

定位 `positioning:`

人设 `persona:`

新人开张 `onboarding:`

写作风格与素材 `kit:`

素材库 `kb:`

腾讯 ima `ima:`

助手 `copilot:`

私域 `privateDomain:`

账号矩阵 `matrix:`

账号 `account:`

平台适配器 `adapter:`

知识星球 `zsxq:`

小红书交接 `handoff:`

内容日历 `calendar:`

海外平台语言 `contentLang:`

AI 模型 `ai:`

配置 `config:`

套餐 `entitlements:`

套餐 `billing:`

字流账号 `cloud:`

同步 `sync:`

平台门禁 `platform:`

应用 `app:`

更新 `update:`

设置（不开放） `settings:`

存储（不开放） `store:`

浏览器（不开放） `browser:`

文件对话框（不开放） `file:`

回复取证（不开放） `reply:`

AI Agent 设置（不开放） `agent:`

调试（不开放） `debug:`