配置指南

欢迎使用 SilentFlow。本教程将引导您完成从账号激活到无感写作的全过程。
通常只需要 3-5 分钟即可配置完成。

1

获取与激活密钥

SilentFlow 采用预付费周期订阅。您需要先获取兑换码 (CDK),再激活账号生成 API 密钥。

  1. 购买兑换码: 前往 价格页面 选择适合您的套餐完成订阅并获取 CDK。
  2. 激活账号: 前往 激活页面,输入 CDK 和您的常用邮箱完成绑定。
  3. 保存密钥: 激活成功后,屏幕上会展示您的 API 密钥(以 sk_live_... 开头)。请立即复制并妥善保存。
🔒 安全须知: 密钥仅用于客户端鉴权,请勿将密钥粘贴至公开聊天、代码仓库或不信任的脚本参数中。
激活成功界面示例
图示:激活成功后,请妥善保存好您的 API 密钥
2

配置 PicGo 插件

什么是 PicGo? PicGo 是一个成熟的开源图片上传工具,支持与 Obsidian、Typora 等各类写作工具联动。

安装插件

打开 PicGo 桌面客户端,点击左侧 插件设置,在搜索框中输入 silentflow 并点击安装。

PicGo 插件搜索界面
图示:在 PicGo 插件设置中搜索并安装 silentflow

填入配置参数

安装完成后,在左侧菜单找到 图床设置 -> SilentFlow,填入以下信息:

  • API URL: https://slnt.dev (默认即可)
  • 密钥: 当前公开的 PicGo 插件(1.0.5)调用旧版接口,必须填写账号主密钥sk_live_...);待发布的 1.1.0 及以上版本可使用受限 Agent Key。仅上传需要 files:write,如需在插件中查看用量,再增加 files:read

点击 确定,并将 SilentFlow 设为默认图床

3

配置笔记软件

Obsidian 可配合社区插件实现粘贴图片自动上传并替换链接:

  1. 在 Obsidian 社区插件市场搜索并安装 Image Auto Upload Plugin
  2. 启用插件后进入设置页,在 Default Uploader 选项中选择 PicGo (app)
  3. 建议保留本地备份: 建议在笔记库 (Vault) 或本地指定目录中保留原图备份,遵循本地优先与云端分发的双重保障。
  4. 测试验证: 在 Obsidian 任意笔记中粘贴一张图片,确认上传成功并自动生成外链 Markdown 语法。
Obsidian Image Auto Upload Plugin 设置界面
4

网页控制台

SilentFlow 提供轻量网页控制台,方便在任意设备上查看配额与管理图片资产。

如何登录

访问 控制台页面,输入您的 API 密钥 即可登录。

💡 移动端友好: 控制台适配手机与平板浏览器,支持从相册选择图片上传并复制 Markdown 链接。

主要功能

  • 用量概览: 查看当前存储空间使用量、套餐有效期与本月已用流量。
  • 原图上传: 拖拽或点击选择图片上传,原图直传并生成外链。
  • 资产管理: 浏览上传历史,一键复制 URL 与 Markdown 引用。
5

AI Agent 与 CLI 接入

如果您使用 AI 编程助手(如 Cursor、Claude Code 等)或编写本地发布脚本,SilentFlow 提供了标准 REST API 与零依赖 JSON CLI。

开发者与 AI 接入指南

包含 Bearer 认证、Scoped Agent Key、cURL 规范、OpenAPI 与 llms.txt 机器可读文档。

查看开发者文档 →

常见问题

Q: 为什么上传返回 401 或 403?

401 表示密钥缺失、无效或已撤销;403 通常表示账号被禁用或已过期、存储配额不足、产品不可用,或 Agent Key 缺少 files:write 权限。请前往 控制台 检查账户与配额状态。月流量超限只影响公开读取,不直接阻止上传。

Q: 如何查看当前已用流量与存储空间?

登录 控制台 即可实时查看存储占用与月流量进度;开发者也可调用 GET /v1/usage 接口获取。