开发者/概览

字流开发者文档

字流把桌面端的全部能力开放给 AI Agent 和你自己的脚本：选题、写稿、配图、口播剪辑、AI 成片、送 26 个平台发布、评论私信、复盘。Agent 调的和你在界面上点的是同一套代码，结果都在字流里，随时可以接着手动改。

两套接口，选哪个

	本机接口（桌面端）	云端 API（网页版）
地址	`http://127.0.0.1:17616`	`https://ziliu.online/api`
令牌	`ziliu_local_…`，在桌面端「设置 → 更多 → AI Agent → 开发者选项」	`ziliu_sk_…`，在网页版「设置 → API Keys」创建
能做什么	全部 308 个能力（252 个开放），含写稿、剪视频、填稿发布、评论、复盘	文章 / 短图文 / 视频稿的存取、上传图片视频、发布预设、OpenAI 兼容的 AI 接口
前提	字流桌面端开着，只能本机访问	能联网就行，任何机器都能调
适合	Claude Code、Codex、WorkBuddy、Kimi Code 等本机 Agent；本机脚本	服务器上的自动化（OpenClaw、n8n、Hermes）把成稿推进字流

大多数人用本机接口：在桌面端点一下就接进你的 AI Agent，不用写代码。服务器上的自动化要往字流里推稿，用云端 API。

三种用法

在 AI Agent 里用（不写代码）
桌面端「设置 → 更多 → AI Agent」点你在用的 Agent，接好后直接对它说「把这个想法写成公众号和小红书，填进发布页」。见接入 AI Agent。
写脚本调本机接口
任何语言发 HTTP 请求就行：POST /v1/call/<能力名>，请求体就是参数。见 5 分钟跑通和本机接口。
从服务器推稿到字流
用网页版的 API Key 调云端 API 建文章，桌面端自动同步过来再改编、配图、分发。见云端 API。

安全分级

每个能力都有一个风险级，写在能力参考里，也在 GET /v1/catalog 的返回里：

风险级	例子	规则
read 只读	看选题、看稿、看数据、看复盘	直接调；免费版也能用
write 改本地	写稿、改稿、生图、剪视频、把稿子填进发布页（不公开）	直接调；要创作者版或矩阵版；花云点的目录里标了 `costsPoints`
public 会公开	点「发布」、发评论回复、改线上公众号自动回复	默认关。用户在设置里打开「允许 AI 代点发布」后，每次请求还要带 `"confirm": true`
blocked 不开放	密钥、登录扫码、付款、选文件对话框、开窗口	永远 403，只能用户自己在字流里操作

一些数字

308 个能力：只读 89、改本地 149、会公开 14、不开放 56；其中 51 个会花云点。
限速：每分钟最多 120 次，其中花云点的最多 15 次，超了返回 429 和要等几秒。
MCP 服务 13 个工具；官方 skills 5 个；一键接入支持 Claude Code、Codex、WorkBuddy、CodeBuddy、Kimi Code、Trae、iFlow，Qoder、通义灵码、Cherry Studio 粘一段配置就行。

文档目录