ShareX 集成
PicFast 提供完整的 ShareX 支持。ShareX 是 Windows 平台免费开源的截图与文件上传工具。
一键配置
先在 设置 → API Token 中创建一个 API 令牌(或使用已有的 — 令牌仅在创建时显示一次,请妥善保存)。然后进入 接入方式 页面,填入或选择你的令牌,下载个性化 ShareX 配置文件。在 ShareX 中通过 目标 → 导入 → 从文件导入 完成配置。
下载的配置文件已包含你的 API 令牌与服务器地址,无需手动填写。接入方式页面中其他工具的配置复制也遵循同样的流程。
手动设置
也可在 ShareX 中创建自定义上传器手动配置:
请求设置
| 字段 | 值 |
|---|---|
| 请求 URL | https://picfast.example.com/api/v1/sharex/upload |
| 请求方法 | POST |
| 请求体 | multipart/form-data |
| 文件表单名 | file |
| 参数名 | key |
| 参数值 | 留空 |
| 请求头 | Authorization: Bearer YOUR_TOKEN |
响应设置
| 字段 | 值 |
|---|---|
| 响应类型 | JSON |
| URL | json:$.url |
| 缩略图 URL | json:$.thumbnail_url |
验证
在 ShareX 中截图或上传文件,图片 URL 将自动复制到剪贴板。默认同时提供 Markdown 格式链接。
常见问题
- 请确保
server.base_url已设置为实际访问域名,ShareX 配置文件生成器会基于该值构造请求 URL。 - 若上传超时,请检查反向代理的
client_max_body_size是否大于等于分组的上传体积限制。 - 若 API token 失效,可在 PicFast 的设置页面中重新生成。