API 接口

说明：未注册用户或未生成 API Token，无需 API Token 即可访问公共图库，但无法调用他人或自己图库的私有图片。生成 Token 后可通过 Authorization Header 或 URL 参数 ?tk= 进行认证访问。

参数配置

勾选后返回中等尺寸图片，参数 pic=md

API 地址

/api/images/random?count=1&pic=md

调用方法

# 方式一：通过 Authorization Header
curl -H "Authorization: Bearer YOUR_TOKEN" \
     "/api/images/random?count=1&pic=md"

# 方式二：通过 URL 参数
curl "/api/images/random?count=1&pic=md&tk=YOUR_TOKEN"

返回参数结构

{
  "说明": "count=1 时直接返回图片二进制（Content-Type: image/jpeg），不返回 JSON",
  "count > 1 时返回": {
    "images": [
      {
        "id": 1,
        "filename": "...",
        "url": "/image/...",
        "width": 1920,
        "height": 1080
      }
    ]
  },
  "认证方式二选一": [
    "Authorization: Bearer <token>",
    "URL 参数: ?tk=<token>"
  ]
}

实时预览

点击"刷新"获取实时数据