兰空图床(Lsky Pro)API 获取 Token 教程

前言

在使用兰空图床(Lsky Pro)对接第三方应用或自动化上传时,通常需要通过 API 获取用户 Token,以便后续进行认证、上传、管理图片等操作。

本教程将详细讲解如何通过 API 正确获取 Lsky Pro Token,支持 Postman、curl 命令行两种方式操作。(适用于 Lsky Pro 2.x 版本及以上)

📌 小提示:本文以 Lsky Pro v2.1 为例,其他新版接口基本一致。

1. 准备工作

在开始之前,请确认以下几点:

  • 已部署好 Lsky Pro 图床,并可以正常访问。
  • 确认图床版本为 2.x 以上(支持标准 API 接口)。
  • 服务器 Nginx 配置正确,确保 /api/v1/ 路由能被转发到程序(否则访问 API 会 404),正常安装的基本不用改任何配置,直接下一步就可以。
  • 已有一个注册好的 Lsky Pro 账号(邮箱 + 密码)。

2. 获取 API 地址

Lsky Pro 标准 API 入口图床管理的后台 接口 都可以看到,地址为:https://yourdomain.com/api/v1/
例如,如果你的图床部署在:https://img.yourdomain.com 那么获取 Token 的接口地址就是:https://img.yourdomain.com/api/v1/tokens
⚡ 注意:很多 AI 教程说的获取地址是 token(不带 s)是不对的,访问会 404。

3. 通过 Postman 获取 Token

Postman 是常用的 API 调试工具,推荐用它来第一次验证接口是否通畅。

Postman 设置步骤

Postman 步骤 1

Postman 步骤 2

Postman 步骤 3

(1)新建请求

  • 方法:默认是 GET,切换到 POST
  • 地址:https://yourdomain.com/api/v1/tokens

(2)设置 Headers

Key Value
accept application/json

(3)设置 Body(两种模式)

Postman x-www-form-urlencoded

点击 x-www-form-urlencoded,填写以下信息:

Key Value
email Lsky注册邮箱
password 你的Lsky密码

点击 SEND,如果成功,返回如下数据:

{
    "status": true,
    "message": "success",
    "data": {
        "token": "2|VaVEjmjlCl9nHb****ULJf96reeEVY"
    }
}

然后你就可以在需要用的地方填入该 Token 了。

(4)采用 JSON 模式获取

Postman JSON 模式

点击 Body → 选择 raw → 选择 JSON,填写:

{
  "email": "admin@example.com",
  "password": "yourpassword"
}

点击 SEND,如果正确,返回:

{
  "status": true,
  "message": "success",
  "data": {
    "token": "1|1bJbwlqBfn**************IwqiZjCDs7r1Ob5"
  }
}

至此,你就获得了 Lsky Pro 的 Token,可以用于上传、管理图片等场景了。