萌える嘘二次元随机图API食用说明

截至2023年7月28日，这里已经收集了10万+的图片啦！总大小超过325GB！

不来这里抽个卡嘛~( •̀ ω •́ )y → Gacha

本随机图API基于 islandworld 分享的数据，B站美图UP主们分享的图片和咱搜集的壁纸制作，图片绿色健康

随机图API及图床均已转为使用某些白嫖服务搭建，故为保障使用体验和稳定性，API有一定的调用限制，具体见下文

食用方法

API地址：https://imgapi.lie.moe/random
调用方法：GET

速率和每日额度限制说明：

API限制：每IP每5秒内可以调用3次API，超出返回429

此外，请注意，每个IP每24小时内仅可通过API获取10000张图片
达到限度后将无法使用API，API地址返回状态码403并给出恢复时间

您可以 访问这里 以在不消耗额度的情况下查询您IP的剩余可用额度或可用额度恢复倒计时

传入参数说明：

键 键描述 值类型 可用的值 值描述
sort 索引的图片集
(可选，默认为approve)		 Text random
approve
top
cat
yin
mp
pc
tuzi		 索引全部图片
索引过审图片 (90315P)
索引精选图片 (3945P)
索引兽耳图片 (2510P)
索引银发图片 (2060P)
索引竖屏壁纸 (1813P)
索引横屏壁纸 (1770P)
索引点兔图片 (2384P)
type 输出方法
(可选，默认为重定向)		 Text text
json		 输出文本
输出JSON格式
num 输出图片数量
(可选，当num大于1时type固定为json)		 Integer 小于等于100的任意正整数
若不携带num则默认为1
thumbnail 使用缩略图(可选) Text large
medium
small		 最长边重设为800px
最长边重设为176px
最长边重设为96px
noproxy 不使用CF代理(可选) Any 任意真值，或不携带此参数
only_check 检查可用额度
(可选，当此参数为任意真值时其它参数无效)		 Any 任意真值，或不携带此参数

Note：
更新时间：2023年11月18日(UTC+0)
重要提示：通常，图床会使用CF代理图片，这可能在某些地区速度更快；但如果您需要直连源站下载，请携带noproxy参数
图片审核使用 阿里云内容安全API
缩略图功能由 Microsoft Azure 提供
图片均来自互联网，来源众多无法确认版权信息，侵删

Demo： 

GET https://imgapi.lie.moe/random
GET https://imgapi.lie.moe/random?thumbnail=large
GET https://imgapi.lie.moe/random?sort=top
GET https://imgapi.lie.moe/random?sort=cat&type=text
GET https://imgapi.lie.moe/random?sort=yin&num=100
GET https://imgapi.lie.moe/random?only_check=true

返回参数说明：

注意：当携带num参数且num参数大于等于2时，API只会输出JSON格式

传入type 返回值 Demo
text 图片URL 
https://imghost.lie.moe/2023/02/05/63e1b85fb27e9.jpg
json pic: 图片URL(s)数组
remain_num: 剩余额度 
{
    "pic": ["https:\/\/imghost.lie.moe\/2023\/02\/05\/63e1b85fb27e9.jpg"],
    "remain_num": 2333
}
其它 重定向到图片URL

将随机图API设置为网页背景

Demo(CSS)： 

html:before {
    background: url(https://imgapi.lie.moe/random) no-repeat center 0/cover;
    position: fixed;
    width: 100%;
    height: 100%;
    top: 0;
    left: 0;
    z-index: -1;
    content: "";
}

为了避免页面加载被过大的背景图阻塞导致加载缓慢，也可换用下面的方法

Demo(HTML)： 

<style>
.withBg:before {
    background: url(https://imgapi.lie.moe/random) no-repeat center 0/cover;
    position: fixed;
    width: 100%;
    height: 100%;
    top: 0;
    left: 0;
    z-index: -1;
    content: "";
}
</style>
<script>window.onload = () => document.documentElement.classList.add("withBg");</script>

一个输出壁纸轮播HTML的API

API地址：https://imgapi.lie.moe/player
调用方法：GET

传入参数说明：

键 键描述 值类型 值描述
time 每张图片的持续时间，单位为秒
(可选，默认为10)		 Integer 大于等于5的任意正整数
若不携带time则默认为5

以下是在网页中插入随机轮播背景的使用例

Demo(HTML)： 

<iframe src="https://imgapi.lie.moe/player?time=10" style="position:fixed;top:0;left:0;width:100%;height:100%;z-index:-1;border:none;overflow:hidden;"></iframe>

API调用统计

图片总数 总调用量 总图片查看量 今日调用量 今日图片查看量
110417

Note：时区使用UTC+0

鸣谢

随机图API的搭建离不开以下B站UP主的分享，在此表达衷心的感谢！(UID正序)

islandworld  PaoMianの  轻百萌豚  学姐圆  星绘汐音  空美町  一只喵喵酱y  諸星小紬  玟w玟_  奶昔酱不会忧郁丶  约尔yuer  和之凌雪  小朱不只是可爱  游手好闲的孟极  萌村百科

友情链接

非常好用的AI以图识番(Gal)网站：AnimeTrace

图床缓存由 Cloudflare 提供服务
亚太加速由 雨云 提供服务
图床源站由 Microsoft Azure 提供服务
部分方法已在 GitHub 开源