GET
https://api.illlights.com/v1/img
API 会将客户端 302 重定向到 https://api.illlights.com/v1/imgs/{file_name}
,直接从服务器下载图片。
注意,如果直接使用浏览器访问这个链接(请求不带 referer),会返回一个简单的 HTML 页面显示图片,返回如下
<img src="${Image Link}" alt="${Image Link}" width="540"/>
绝大部分是解包得到的图片,因为流量和传输速度问题,所有图片都经过压缩,使用 ImageMagick 压缩图片,返回 avif 格式图片。如果需要原图或者想要调用原图,请联系我获取原图接口。
尺寸方面,各个公司制作的分辨率和格式不同,返回图片的分辨率不一样,你可以通过指定原图分辨率参数获取特定分辨率的图片。
图片内容不含 18+ 内容,可能有一部分图片有 16+ 内容,请勿在非常正式的网站和应用中使用。
所有图片都是我一张一张挑选选出,只放我玩过的、且我觉得画风很好的图片,只对我自己的取向负责,现阶段不考虑大规模扩充图库。不过也就是说每张图的质量都不低!
图片数据库详细细节请在这里查看。
直接嵌入HTML中,由浏览器调用渲染
<img src="https://api.illlights.com/v1/img" alt="示例图片">
size
540
720
1080
1440
2160
https://api.illlights.com/v1/img?size=540
指定原图分辨率,就是从数据库中搜索出指定的分辨率图片再随机给客户端。
注意!该参数不是把原图调成该分辨率再返回,而是在数据库中查找原图分辨率是这一尺寸的图片,所以指定原图分辨率会使随机的范围大幅减小.
部分作品的图片只有一种分辨率,指定原图分辨率会导致无法随机到一些作品,若同时执行其他请求参数导致数据库中无结果,返回 404 错误。
只有上述五种可选的原图分辨率参数,错误的查询会返回 403 错误。
name
https://api.illlights.com/v1/img?name=千恋
根据数据库中 Name 字段匹配筛选图片并随机返回其中一条。不区分大小写,使用匹配形式查找:只要这张图片的 Name 字段中有你搜索的这段字符就可能被随机到。例如 Example 中的请求会随机返回一张 千恋*万花
的 CG 图片。
数据库中 Name 至少会有官方的作品名称,一些作品的官方名称是英文,但更多的是日语,后续会扩充数据库内容加入更多的名称。详细图片作品介绍见Galgame CG 数据库。
没有查找到图片会返回 404 错误。