KiteKite

第三方客户端

将 Kite 接入 PicGo、ShareX 等主流图床客户端。

Kite 的上传接口原生兼容 兰空图床 v2 协议，因此大部分主流图床客户端都可以直接使用。

创建 API Token

所有第三方上传都应使用 API Token 而非账号密码：

  1. 登录后台 → 个人中心 → API Token
  2. 点击「创建」，填写名称（如 PicGo）
  3. 立即复制生成的 Token（只显示一次）
  4. 后续在客户端中使用该 Token
注意

Token 以 SHA256 哈希存储，生成后无法再次查看明文。丢失请删除后重建。

PicGo

PicGo 是最流行的图床客户端之一，通过兰空图床插件可无缝对接 Kite。

安装插件

在 PicGo 的「插件设置」中搜索 lankong，安装 Lankong Image Uploader。

配置

字段值
版本选择V2
域名https://kite.your-domain.com
TokenBearer <你的 API Token>
相册 ID可选，指定上传到某个相册
存储策略 ID留空使用默认
权限0（私有） / 1（公开）
说明

Token 字段需要包含 Bearer 前缀，否则鉴权会失败。这是兰空协议的约定。

快捷键

PicGo 默认支持 Ctrl+Shift+P（Windows）/ Cmd+Shift+P（macOS）一键上传剪贴板图片。

ShareX

ShareX 是 Windows 上的截图 + 上传神器。

自定义 Uploader

新建一个 Custom Uploader：

JSON
{
  "Version": "15.0.0",
  "Name": "Kite",
  "DestinationType": "ImageUploader, FileUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://kite.your-domain.com/api/v1/upload",
  "Headers": {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
  },
  "Body": "MultipartFormData",
  "FileFormName": "file",
  "URL": "{json:data.links.url}",
  "ThumbnailURL": "{json:data.links.thumbnail_url}",
  "DeletionURL": "{json:data.links.delete_url}"
}

应用后，ShareX 截图会自动上传到 Kite。

uPic / iPic (macOS)

以 uPic 为例：

  1. 打开偏好 → 图床设置 → 添加「自定义」
  2. 配置：
    • API URL：https://kite.your-domain.com/api/v1/upload
    • Method：POST
    • File Field Name：file
    • Headers：Authorization: Bearer YOUR_TOKEN
    • URL Path：data.links.url

curl 命令行

最底层的方式，用于脚本化上传：

BASH
curl -X POST https://kite.your-domain.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@/path/to/image.png"

响应示例：

JSON
{
  "status": true,
  "message": "success",
  "data": {
    "key": "2026/04/a1b2c3d4/uuid.png",
    "name": "image.png",
    "size": 123456,
    "md5": "a1b2c3d4…",
    "links": {
      "url": "https://kite.your-domain.com/i/a1b2c3d4",
      "thumbnail_url": "https://kite.your-domain.com/t/a1b2c3d4",
      "markdown": "![image](https://kite.your-domain.com/i/a1b2c3d4)",
      "html": "<img src=\"https://kite.your-domain.com/i/a1b2c3d4\" alt=\"image\">"
    }
  }
}

Obsidian

使用 Obsidian Image Upload Toolkit 或 Image Auto Upload 插件，配置兰空兼容后端即可。

Typora

Typora 自身不支持 HTTP 上传，但可以通过命令行工具桥接。在 文件 → 偏好设置 → 图像 中：

  • 上传服务：Custom Command
  • 命令：curl -X POST https://kite.your-domain.com/api/v1/upload -H "Authorization: Bearer YOUR_TOKEN" -F "file=@$1" | jq -r '.data.links.url'

短链格式

Kite 为每个文件生成五种类型的短链：

前缀含义典型用途
/i/:hash图片浏览器内联展示
/v/:hash视频<video> 标签
/a/:hash音频<audio> 标签
/f/:hash下载链接（带 Content-Disposition）直接下载
/t/:hash缩略图列表、预览

:hash 为文件 MD5 的前 8 位，由系统保证在同一实例内唯一。

下一步