随机动漫图片 API 文档

一个专注于提供高质量随机二次元壁纸的免费接口，支持横竖屏自适应，走 CDN 分发加速。请求一次，返回一张随机动漫图片。

目前图库收录 1053 张横屏、2604 张竖屏 资源，累计调用 23 万多次，持续扩充中。

在线预览#

1
https://rimg.zhuqiy.top/api/random

GET

参数	必填	说明
`type`	否	图片方向。`pc` 返回横屏，`mb` 返回竖屏。缺省时根据 User-Agent 自动判断

接口返回 302 重定向，Location 指向一张随机图片的直链。

不带 type 参数时，接口会根据请求的 User-Agent 自动判断图片方向：

推荐在明确知道使用场景时直接指定 type 参数，避免 UA 判断误差。

1
https://rimg.zhuqiy.top/api/random?type=pc

1
https://rimg.zhuqiy.top/api/random?type=mb

1
https://rimg.zhuqiy.top/api/random

浏览器直接打开即可看到随机图。想在代码里用也很简单，比如 HTML 里当图片：

1
<img src="https://rimg.zhuqiy.top/api/random?type=pc" alt="随机动漫壁纸" />

或者用 CSS 做全屏背景：

1
body {
2
  background-image: url("https://rimg.zhuqiy.top/api/random?type=mb");
3
  background-size: cover;
4
}

前端 JS 里想换图，重新设置一下 src 就行，每次都会拿到一张新的：

1
const img = document.getElementById("wallpaper");
2
img.src = "https://rimg.zhuqiy.top/api/random?type=pc";

问题原因：浏览器缓存导致的。因为引用的 URL 完全一致，浏览器会直接复用缓存，不会重新请求。

解决办法：在 URL 后面加一个任意不同的查询参数，让浏览器不要复用缓存。

1
<img src="https://rimg.zhuqiy.top/api/random?type=pc&1" alt="随机动漫壁纸" />
2
<img src="https://rimg.zhuqiy.top/api/random?type=pc&2" alt="随机动漫壁纸" />

图库要持续扩充，光靠我一个人收集肯定不够。如果你手头有好看的动漫壁纸，欢迎发送到邮箱 admin@zhuqiy.com，审核通过后就会收录进图库。