服务运行中 · 稳定交付 — 天

随机图片直链 API 一行代码，即刻接入

多分类、多格式的高质量随机图片服务。直接返回图片二进制流，无需解析 JSON，可嵌入网站、App 与小程序。

接口地址 /random

检测中 · 正在连接接口 — 个分类 — 张图片图片直出

低延迟随机

随机取图只做一次计数 + 随机偏移定位，不做全表排序；/random 每次返回新图、不缓存，/image 直链带 7 天缓存。

分类随心取

按分类随机，无需解析 JSON，图片随取随用。

稳定可依赖

支持跨域访问、路径安全校验与访问统计，异常请求返回结构化错误码。

在线体验

v—

点击「换一张」获取随机图片

尚未加载

开发者文档

全局随机

直接请求以下地址，服务会从所有分类中随机返回一张图片。随机接口不做缓存，每次请求都会返回不同图片（需要缓存请用下面的 /image 直链）：

按分类随机

通过 type 参数限定分类（需 URL 编码）：

缩略图

列表、卡片这类场景加 w 参数即可拿到窄图，避免拉原图浪费流量。请求头带 Accept: image/webp 时返回 WebP（通常比 JPEG 小 25% 以上），否则返回 JPEG：

指定图片直链

已知图片路径时，可通过 path 参数获取固定图片（支持 7 天浏览器缓存）：

参数	类型	默认	状态	说明
type	string	—	已支持	按分类筛选，留空则从全部分类随机
path	string	—	已支持	固定图片相对路径，用于 /image 接口
format	string	—	已支持	限定图片格式：`jpg / jpeg / png / gif / webp`，可逗号组合；该格式下没有图片时返回 404
exclude	string	—	已支持	排除指定图片 ID，逗号分隔，最多 100 个
w	int	—	已支持	返回指定宽度的缩略图（160/320/480/640/960），带磁盘缓存；客户端支持时自动返回 WebP

组合示例

状态码	含义	响应类型	说明
200	成功	图片二进制流	直接可用的图片内容
404	分类 / 图片不存在	HTML 错误页	分类为空或图片已被移除
422	参数非法	JSON	路径非法或参数校验失败
500	服务异常	JSON	服务端处理出错，含错误 ID

响应头

Content-Type: image/jpeg | image/png | image/gif | image/webp
Cache-Control: no-cache, max-age=0        # /random：保证每次随机
Cache-Control: public, max-age=604800     # /image：直链缓存 7 天
Access-Control-Allow-Origin: *            # 全站开放跨域

分类浏览

按分类查看图片，每个分类都可以直接作为随机接口参数。

—

第 1 / 1 页

分类图片

—

第 1 / 1 页

数据概览

以下数据实时来自接口，非静态示例。

图片分类

—个

可用图片

—张

平均每类

—张

分类占比

—

图片总数

分类图片分布

按数量降序

反馈与支持

常见问题

接口怎么用？

把 /random 当作图片地址用即可，例如 <img src="…/random">。

图片可以用在商业项目吗？

图片由用户自行收集整理，版权归属原作者。商用前请自行确认授权，本项目不承担相关责任。

有调用频率限制吗？

为避免滥用，/random、/image、/thumb 按 IP 限流，默认每分钟 120 次，超限返回 429 并带 Retry-After。请勿在循环中高频调用，图片请配合 w 参数取缩略图。

为什么每次打开图片都不一样？

/random 接口本身即随机，且响应头禁止缓存；如果需要固定图片，请使用 /image?path=… 直链。