客户端工具

PicFast 提供扁平上传端点 /api/v1/flat/upload，返回简洁的 JSON 响应，非常适合对接第三方上传客户端。以下工具均使用同一接口。

PicGo / PicList

安装 PicGo 或 PicList，在插件设置中搜索并安装 web-uploader 插件。
在图床设置中选择「自定义 Web 图床」，填入下方配置。

{
  "picBed": {
    "uploader": "picgo-plugin-web-uploader",
    "picgo-plugin-web-uploader": {
      "url": "https://picfast.example.com/api/v1/flat/upload",
      "paramName": "file",
      "jsonPath": "url",
      "customHeader": "{\"Authorization\": \"Bearer <YOUR_API_TOKEN>\"}"
    }
  }
}

uPic

在 uPic 中选择「自定义」图床，按以下配置填写：

字段	值
URL	`https://picfast.example.com/api/v1/flat/upload`
Method	`POST`
File Field	`file`
Header	`Authorization: Bearer <YOUR_API_TOKEN>`
URL Path	`["url"]`
Domain	`https://picfast.example.com`

Dropshare

在 Dropshare 中选择 Custom API 连接，按以下配置填写：

字段	值
Upload URL	`https://picfast.example.com/api/v1/flat/upload`
Method	`POST`
Content Type	`multipart/form-data`
Form Field	`file`
Header	`{"Authorization": "Bearer <YOUR_API_TOKEN>"}`
Response Content Type	`JSON`
URL to file	`%url%`

 Obsidian
 安装社区插件 Image auto upload，选择 PicGo 作为上传服务。粘贴到笔记中的图片将自动上传至 PicFast 并替换为返回的 URL。
 API Token
 在 PicFast 管理后台的「设置 → API Token」中创建。Token 以 img_ 为前缀，支持权限范围限定（如仅允许上传）。将 Token 填入以上所有工具的 Authorization: Bearer 请求头中。