随机图 API

随机图 API 允许您从图床中随机获取一张图片，适用于网站背景、占位图等场景。

基本信息

• 端点：/random
• 方法：GET
• 前置条件：需要开启随机图功能

请求参数

参数名	类型	必需	默认值	说明
content	string	否	image	文件类型过滤，可选值有[image, video]，多个使用,分隔
type	string	否	path	返回内容类型，设为img时直接返回图片（此时form不生效），设为url时返回完整url链接
form	string	否	json	响应格式，设为text时直接返回文本
dir	string	否	-	指定目录，使用相对路径，例如img/test会返回该目录以及所有子目录下的文件
orientation	string	否	-	图片方向筛选，可选值：landscape（横图）、portrait（竖图）、square（方图）

响应格式

1、当type为img时：返回格式为image/jpeg

2、当type为其他值时：

• 当form不是text时，返回JSON格式内容，data.url为返回的链接/文件路径
• 当form是text时，直接返回链接/文件路径

示例

基本请求

curl --location --request GET 'https://your.domain/random'

获取横图

curl --location --request GET 'https://your.domain/random?orientation=landscape'

获取指定目录的竖图

curl --location --request GET 'https://your.domain/random?dir=wallpaper&orientation=portrait'

直接返回图片

curl --location --request GET 'https://your.domain/random?type=img&orientation=landscape'

响应示例

{
 "url": "/file/4fab4d423d039b4665a27.jpg"
}

使用场景

网站随机背景

<img src="https://your.domain/random?type=img&orientation=landscape" alt="随机背景">

CSS 背景图

.hero {
  background-image: url('https://your.domain/random?type=img&orientation=landscape');
  background-size: cover;
}

手机壁纸 API

https://your.domain/random?type=img&dir=mobile&orientation=portrait