端点列表

方法路径说明
GET/anime/random直接返回随机插画(自动适配横竖屏,本域名直出)
GET/anime/jsonJSON 格式返回插画 URL 与实际方向

请求参数

参数适用端点取值说明
orientation全部landscape / portrait / auto强制横屏 / 竖屏;不传即自动适配设备方向
t / ts全部任意字符串(如时间戳)种子:同一值固定返回同一张图,缺省则随机

不传 orientation 就会自动适配:优先按 Client Hints 视口宽高判断,其次按 User-Agent(手机→竖屏、电脑/平板→横屏)。orientation 也支持 horizontal、vertical、h、v、横屏、竖屏、auto / 自动 等写法。

时间戳固定图片:t / ts 接受任意字符串,最常用的就是时间戳。同一个值必定返回同一张图,换值即换图,不传则每次随机。想「每天固定一张」就传当天 0 点的秒级时间戳(如 ?t=1728000000),跨过当天会自动换图。

使用示例

插画 · 自动适配横竖屏,本域名直出图片
GET /anime/random
插画 · 仅横屏
GET /anime/random?orientation=landscape
插画 · 仅竖屏
GET /anime/random?orientation=portrait
插画 · 时间戳固定,同值恒为同一张
GET /anime/random?t=1728000000
插画 · JSON 响应
GET /anime/json

响应示例

/anime/json 响应
{
  "code": 200,
  "message": "success",
  "url": "https://api.jerrynis.com/anime/random",
  "type": "image",
  "orientation": "landscape"
}
详细信息
插画 JSON → 直接看一张 →

在线预览

点击按钮加载随机二次元插画