端点列表
| 方法 | 路径 | 说明 |
|---|---|---|
| 🎨 ba随机官方图(记忆大厅 + 部分剧情) | ||
| GET | /ba/random | 直接返回随机官方 BA 图片(本域名直出,不跳转) |
| GET | /ba/json | JSON 格式返回随机官方图片 URL |
| 🖥️ ba随机壁纸(横屏 + 竖屏) | ||
| GET | /ba/wallpaper | 直接返回随机 BA 壁纸(自动适配横竖屏,本域名直出) |
| GET | /ba/wallpaper/json | JSON 格式返回随机壁纸 URL |
请求参数
| 参数 | 适用端点 | 取值 | 说明 |
|---|---|---|---|
orientation | 壁纸 | landscape / portrait / auto | 强制横屏 / 竖屏;不传即自动适配设备方向 |
t / ts | 全部 | 任意字符串(如时间戳) | 种子:同一值固定返回同一张图,缺省则随机 |
壁纸默认就会自动适配:优先按 Client Hints 视口宽高判断,其次按 User-Agent(手机→竖屏、电脑/平板→横屏)。orientation 也支持 horizontal、vertical、h、v、横屏、竖屏、auto / 自动 等写法,显式传 auto 与不传效果相同。
时间戳固定图片:t / ts 接受任意字符串,最常用的就是时间戳。同一个值必定返回同一张图,换值即换图,不传则每次随机。想「每天固定一张」就传当天 0 点的秒级时间戳(如 ?t=1728000000),跨过当天会自动换图。
使用示例
官方图 · 本域名直出图片
GET /ba/random
壁纸 · 自动适配横竖屏
GET /ba/wallpaper
壁纸 · 仅横屏
GET /ba/wallpaper?orientation=landscape
壁纸 · 仅竖屏
GET /ba/wallpaper?orientation=portrait
壁纸 · 时间戳固定,同值恒为同一张
GET /ba/wallpaper?t=1728000000
壁纸 · JSON 响应(同样自动适配)
GET /ba/wallpaper/json
响应示例
/ba/json 响应
{
"code": 200,
"message": "success",
"url": "https://api.jerrynis.com/ba/random",
"type": "image"
}
/ba/wallpaper/json 响应
{
"code": 200,
"message": "success",
"url": "https://api.jerrynis.com/ba/wallpaper",
"type": "image",
"orientation": "landscape"
}
详细信息
- 官方图:记忆大厅 + 部分剧情场景的随机图片
- 壁纸:横屏 1042 张(最高 8060×5691)+ 竖屏 501 张(最高 6600×10327),均为 .webp;默认按设备自动适配横竖屏,可用 orientation 强制指定
- 图片端点直接返回图片字节,地址始终是本域名,不会跳转到图床;图库走双源:jsdmirror 为主源,超时或失败自动切 R2 回源
在线预览
点击按钮加载随机 BA 图片