随机图 API

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

基本信息

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

请求参数

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

响应格式

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

2、当type为其他值时：

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

示例

请求示例

curl --location --request GET 'https://your.domain/random' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)'

响应示例

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