📡 API 接口文档

UmHub 提供公开的随机图片 API，可用作博客头像、QQ机器人、网站装饰等场景

GET 随机图片

每次请求随机返回一张已审核通过的鱿米图片，直接输出图片二进制数据

/api/random

直接在浏览器打开即可看到随机图片，也可嵌入网页：

🔗 试试看

参数	说明	示例
`tag`	按标签筛选	`?tag=搞笑`
`type`	图片类型：`static` / `gif`	`?type=gif`
`json`	返回 JSON 格式（含标题、ID）	`?json`

参数可自由组合，如 /api/random?tag=可爱&type=gif

GET JSON 格式

加上 ?json 参数即可返回结构化数据

/api/random?json

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "title": "猪籽军舰",
    "image_url": "/assets/uploads/thumbs/thumb_xxx.jpeg",
    "original_url": "/assets/uploads/xxx.jpeg",
    "type_label": "静态图片"
  }
}

🔗 试试看

💡 使用场景

网页嵌入：

Markdown：

![随机鱿米](http://umhub.top/api/random)

QQ机器人 / 微信机器人：

const img = await fetch('http://umhub.top/api/random')
// 直接拿到图片，发给用户即可