调用方式 #
https://lovefirefly.moe/rand.html?filetype={all|pic|vid}&rettype={raw|json}&amount={number}
参数说明 #
filetype - 文件类型筛选
all：所有文件（图片和视频）pic：仅图片文件vid：仅视频文件
rettype - 返回类型
raw：直接返回文件内容（重定向到随机文件）json：返回JSON格式的文件信息
amount - 文件数量（仅在 rettype=json 时有效）
- 数字，表示要返回的文件数量
- 默认值：1
返回内容 #
rettype=raw 模式 #
- 返回HTTP 302重定向，浏览器会直接显示图片或播放视频
rettype=json 模式 #
单个文件（amount=1）
{
"name": "流萤-DAME_ovo@opus_899134026012426259-表情包-6.png",
"url": "/img/gallery/%E6%B5%81%E8%90%A4-DAME_ovo@opus_899134026012426259-%E8%A1%A8%E6%83%85%E5%8C%85-6.png",
"filetype": "pic",
"size": "1658728",
"size_h": "1.58 MB"
}
多个文件（amount>1）
[
{
"name": "流萤-mihoyo-立绘-2.jpg",
"url": "/img/gallery/%E6%B5%81%E8%90%A4-mihoyo-%E7%AB%8B%E7%BB%98-2.jpg",
"filetype": "pic",
"size": "7896921",
"size_h": "7.53 MB"
},
{
"name": "流萤-mihoyo-卡牌.jpg",
"url": "/img/gallery/%E6%B5%81%E8%90%A4-mihoyo-%E5%8D%A1%E7%89%8C.jpg",
"filetype": "pic",
"size": "366854",
"size_h": "358.26 KB"
},
{
"name": "流萤-mihoyo-立绘-1.png",
"url": "/img/gallery/%E6%B5%81%E8%90%A4-mihoyo-%E7%AB%8B%E7%BB%98-1.png",
"filetype": "pic",
"size": "21637005",
"size_h": "20.63 MB"
},
{
"name": "流萤-mihoyo-CG-CS_Chap03_Act090_m_塔塔洛夫的决战.mp4",
"url": "/video/%E6%B5%81%E8%90%A4-mihoyo-CG-CS_Chap03_Act090_m_%E5%A1%94%E5%A1%94%E6%B4%9B%E5%A4%AB%E7%9A%84%E5%86%B3%E6%88%98.mp4",
"filetype": "video",
"size": "24207692",
"size_h": "23.09 MB"
},
{
"name": "流萤-mihoyo-CG-CS_Chap03_Act170_m_和萨姆的战斗.mp4",
"url": "/video/%E6%B5%81%E8%90%A4-mihoyo-CG-CS_Chap03_Act170_m_%E5%92%8C%E8%90%A8%E5%A7%86%E7%9A%84%E6%88%98%E6%96%97.mp4",
"filetype": "video",
"size": "13944554",
"size_h": "13.3 MB"
},
{
"name": "流萤-DAME_ovo@opus_899134026012426259-表情包-8.png",
"url": "/img/gallery/%E6%B5%81%E8%90%A4-DAME_ovo@opus_899134026012426259-%E8%A1%A8%E6%83%85%E5%8C%85-8.png",
"filetype": "pic",
"size": "1018127",
"size_h": "994.26 KB"
}
]
错误响应 #
数据库加载失败：
{
"error": "db load error",
"message": "【错误信息】"
}
没有找到文件：
{
"error": "file not found",
"database_info": {
"generated": "【数据库生成时间】",
"total_files": "【总文件数】",
"pics_count": "【图片数量】",
"videos_count": "【视频数量】"
}
}
