Random Image API
GitHub

随机图片 API

简单、快速、免费的随机图片服务。根据设备方向自动挑选横屏或竖屏图片，支持 302 重定向与 JSON 两种返回方式。

—
图片总数
—
横屏图片
—
竖屏图片

点击按钮，或按 ← → 切换上一张 / 下一张

预览图片

API 接口

URL 说明 返回
/pic/rpic 默认分类随机图片 302 重定向
/pic/rpic?ua=1 按 User-Agent 判断横竖屏 302 重定向
/pic/rpic?landscape=1 横屏随机图片 302 重定向
/pic/rpic?landscape=0 竖屏随机图片 302 重定向
/pic/rpic?format=json 返回图片 URL 与分类 JSON
/pic/rpicpro?all=... 跨全部分类自定义筛选条件 302 重定向
/pic/rpic?count=1&format=json 统计符合条件的图片数量 JSON

快速使用

直接获取图片（适用于 img 标签、CSS 背景）

获取 JSON 数据（图片 URL 与分类） 

// JSON 响应示例（/pic/rpic?format=json，url 为示意值）
{
  "code": 0,
  "data": {
    "url": "",
    "class": "pixiv"
  }
}

使用示例

HTML

<img src="/pic/rpic?landscape=1" alt="随机壁纸">

CSS 背景

body {
  background-image: url('/pic/rpic?ua=1');
  background-size: cover;
}

JavaScript

fetch('/pic/rpic?landscape=1&format=json')
  .then(res => res.json())
  .then(res => console.log(res.code, res.data.url));