端点列表

方法路径说明
🎨 ba随机官方图(记忆大厅 + 部分剧情)
GET/ba/random直接返回随机官方 BA 图片(本域名直出,不跳转)
GET/ba/jsonJSON 格式返回随机官方图片 URL
🖥️ ba随机壁纸(横屏 + 竖屏)
GET/ba/wallpaper直接返回随机 BA 壁纸(自动适配横竖屏,本域名直出)
GET/ba/wallpaper/jsonJSON 格式返回随机壁纸 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"
}
详细信息
官方图 JSON → 壁纸 JSON →

在线预览

点击按钮加载随机 BA 图片