由于请求压力过大,图床 API 可能较缓慢,有秒加载需求可以群组联系(付费服务)
API 列表
图片随机 API v1 (2019.09.16)
http(s)://ovo.fghrsh.net/v1/?encode=[模式(可选)]&src=[参数(可选)]&callback=[回调(可选)]
-
输出模式
-
默认:跳转到图片外链,仅支持单张
-
json
:详细的 JSON 输出,支持多张随机 -
html
:简单排版的 HTML 输出,支持多张随机 -
origin
:跳转到图床的图片详情链接,仅支持单张 -
请求参数
-
参数名、参数值 用
_
分割,多个参数 用/
分割
-
width
:宽度,支持数值、区间(>500
,<2000
,>=1920
,<=1080
,10-100
) -
height
:高度,支持数值、区间(>500
,<2000
,>=1920
,<=1080
,10-100
) -
views
:浏览数,支持数值、区间(>500
,<2000
,>=1920
,<=1080
,10-100
) -
likes
:喜欢数,支持数值、区间(>500
,<2000
,>=1920
,<=1080
,10-100
) -
size
:图片大小,支持数值、区间(>1000
,<10MB
,>=100KB
,<=2MB
,100KB-10MB
)
-
id
:指定图片,支持数字 ID 和 字符 ID(数值或字符) -
user
:指定用户,支持数字 ID,暂不支持用户名(数值) -
album
:指定相册,支持数字 ID 和 字符 ID(数值或字符) -
category
:图片分类,动漫acg
、风景scenery
、表情emoticon
、写真portray
、COScosplay
(字符)
-
ext
:图片格式,支持jpg
、png
、gif
(字符) -
exif
:详细输出(如有,仅 JSON 模式支持,值1
) -
thumb
:输出缩略图(如有,仅 默认 和 HTML 模式支持,值1
) -
medium
:输出中等图(如有,仅 默认 和 HTML 模式支持,值1
) -
limit
:输出数量(数值,仅 JSON 和 HTML 模式支持,最大1000
) -
nsfw
:输出被 标记不安全 但 允许外链 的图片(数值,1
、不限制-1
) -
compress
:图片压缩,参数见 图片处理规则,auto
自动识别格式(字符)
-
debug
:输出执行时间、查询次数和条件(仅 JSON 和 HTML 模式支持,值1
) -
optimize
:随机查询优化(默认开启,条件结果较少时可能起反作用,值0
禁用)
category_acg/nsfw_-1/user_1/likes_>0
参数说明
API 接口随机数据可能会有不超过一周的延迟(异步缓存)
模式、参数、回调全为可选,直接访问 API 会直接随机一张
uid
:你的 用户 ID 是 loading...
json
:JSON 模式兼容支持 JSONP 的 callback 参数(见下方示例)
nsfw
:默认不输出不安全的图片,设置为 -1 不做限制,同时搜索两种图片
optimize
:当 limit
<= 100 时默认启用,筛选条件较少时优化效果显著
compress
:仅支持 默认 和 HTML 模式,使用时会强制 size
参数 <= 20MB
举个例子
调取图片 0k78A 详细信息,JSON 输出
https://ovo.fghrsh.net/v1/?encode=json&src=id_0k78A/exif_1/debug_1随机相册 LsP1 的图片,允许不安全,自动 webp 识别
https://ovo.fghrsh.net/v1/?src=nsfw_-1/album_LsP1/compress_q90.auto随机用户 ID:1 有收藏数的图片,允许不安全,自动 webp 识别
https://ovo.fghrsh.net/v1/?src=nsfw_-1/user_1/likes_>0/compress_q90.auto动漫分类,允许不安全的图片,分辨率 1080P~2K,自动 webp 识别
https://ovo.fghrsh.net/v1/?src=nsfw_-1/category_acg/width_1920-2160/height_1080-1440/compress_q90.auto随机 10 张,动漫分类,JSON 模式,大小 >= 1MB,输出详细信息
https://ovo.fghrsh.net/v1/?encode=json&src=category_acg/size_>=1MB/limit_10/exif_1随机 10 张,动漫分类,JSONP 模式,回调参数 test,输出详细信息
https://ovo.fghrsh.net/v1/?encode=json&src=category_acg/limit_10/exif_1&callback=test随机 20 张,动漫分类,HTML 模式,分辨率 1080P,按 q80.300i.jpeg 压缩
https://ovo.fghrsh.net/v1/?encode=html&src=category_acg/width_1920/height_1080/compress_q80.300i.jpeg/limit_20随机 100 张,表情分类,HTML 模式,缩略图
https://ovo.fghrsh.net/v1/?encode=html&src=category_emoticon/thumb_1/limit_100