随机
获取随机图片(重定向)
0次调用
需要一张随机图片作为占位符或者背景吗?这个接口是你的不二之选。
GET
uapis.cn
/api/v1/random/image
查询参数
2
category
string
(可选)指定图片主类别。
支持的主类别:
furry
(福瑞,UapiPro服务器)bq
(表情包/趣图,UapiPro服务器)acg
(二次元动漫,UapiPro服务器)ai_drawing
(AI绘画,外部图床)general_anime
(动漫图,外部图床)landscape
(风景图,外部图床)mobile_wallpaper
(手机壁纸,外部图床)pc_wallpaper
(电脑壁纸,外部图床)anime
(混合动漫,UapiPro服务器acg + 外部图床general_anime)
如果不指定,将从所有图片中随机抽取(不包含ikun
和 ai_drawing
)。
type
string
(可选,仅UapiPro服务器图片支持)指定图片子类别。
- furry:
z4k
,szs8k
,s4k
,4k
- bq:
youshou
,xiongmao
,waiguoren
,maomao
,ikun
,eciyuan
- acg:
pc
,mb
外部图床类别和anime
混合类别不支持 type
参数。
功能概述
这是一个非常简单的接口,它会从我们庞大的图库和精选外部图床中随机挑选一张图片,然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的 <img>
标签中。
你可以通过 /api/v1/random/image?category=acg&type=4k
这样的请求获取由UapiPro服务器提供的图片,也可以通过 /api/v1/random/image?category=ai_drawing
获取由外部图床精选的图片。
如果你不提供任何 category 参数,程序会从所有图片(包括本地的和URL的)中随机抽取一张(全局随机图片不包含ikun和AI绘画)。
如果你需要更精确地控制图片类型,请使用/image/random/{category}/{type}
接口。
支持的主类别与子类别
- UapiPro服务器图片
- furry(福瑞)
- z4k
- szs8k
- s4k
- 4k
- bq(表情包/趣图)
- youshou
- xiongmao
- waiguoren
- maomao
- ikun
- eciyuan
- acg(二次元动漫)
- pc
- mb
- furry(福瑞)
- 外部图床精选图片
- ai_drawing: AI绘画。
- general_anime: 动漫图。
- landscape: 风景图。
- mobile_wallpaper: 手机壁纸。
- pc_wallpaper: 电脑壁纸。
- 混合动漫
- anime: 混合了UapiPro服务器的acg和外部图床的general_anime分类下的图片。
默认全局随机(未指定category参数)时,不会包含ikun和AI绘画(ai_drawing)类别的图片。
查询参数
category
string(可选)指定图片主类别。
支持的主类别:
furry
(福瑞,UapiPro服务器)bq
(表情包/趣图,UapiPro服务器)acg
(二次元动漫,UapiPro服务器)ai_drawing
(AI绘画,外部图床)general_anime
(动漫图,外部图床)landscape
(风景图,外部图床)mobile_wallpaper
(手机壁纸,外部图床)pc_wallpaper
(电脑壁纸,外部图床)anime
(混合动漫,UapiPro服务器acg + 外部图床general_anime)
如果不指定,将从所有图片中随机抽取(不包含ikun
和 ai_drawing
)。
type
string(可选,仅UapiPro服务器图片支持)指定图片子类别。
- furry:
z4k
,szs8k
,s4k
,4k
- bq:
youshou
,xiongmao
,waiguoren
,maomao
,ikun
,eciyuan
- acg:
pc
,mb
外部图床类别和anime
混合类别不支持 type
参数。
响应
302 / 临时重定向
成功!你的客户端将会被重定向到一张随机图片的URL。
404 / 未找到
未找到指定类别的图片。
500 / 服务器内部错误
服务器内部错误。