Random Image API
GitHub

随机图片 API

简单、快速、免费的随机图片服务。每个目录一个接口，/random 会按访问设备自动挑选横屏或竖屏，支持 302 重定向与 JSON 两种返回方式。

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

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

预览图片

API 接口

URL 说明 返回
/random 所有目录随机，按设备自动选横屏 / 竖屏 302 重定向
/moe images/moe 随机（固定该目录，不看设备方向） 302 重定向
/moemp images/moemp 随机（固定该目录，不看设备方向） 302 重定向
/任意目录名 images 下的每个子目录都是一个接口 302 重定向
/random?return=json JSON 返回，只含一条图片 URL JSON
/random?orientation=v 仅 /random 有效：强制竖屏（h 横屏 / auto 跟随设备，默认 auto） 302 重定向

快速使用

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

获取 JSON 数据（只含图片 URL） 

// JSON 响应示例
{
  "url": ""
}

使用示例

HTML

<img src="/moe" alt="随机壁纸">

CSS 背景

body {
  background-image: url('/random');
  background-size: cover;
}

JavaScript

fetch('/random?return=json')
  .then(res => res.json())
  .then(data => console.log(data.url));