本文目录:

3月份的时候使用Python后端写了一个API,使用Flask库
这个文档已经是3月写的了,因为在开发其他的项目,没什么时间开发主题商店这个功能(文档原本是写了主题商店的使用方法及功能的,因为没开发好这个功能就暂时删掉了那一大段,后面开发出来了会写篇文章说明如何使用)
图片是后端实时生成的,没有客户端的处理
返回的图片是png类型,也可以自定义背景图(背景图不一定也要png)

Url参数

参数名描述默认值是否可选限制
bg背景图片Url有Url长度限制
w生成的图片宽度(px)10241080
h生成的图片高度(px)5761920
lt文字到图片左上角的距离50
l文字到图片左边的距离50
fs文字的字号40
rdfs图片右下角作者声明的字号18不小于8字号
wf在Url中加载字体只支持TTF格式的字体,以后版本可能会支持更多
c(未开发完)更改纯色背景颜色未设置bg参数时才显示纯色
fc更改字体颜色FFFFFF不允许带#号

如果您设置了wf或bg参数,则会先等待字体或图片加载完成,经过后端处理后,才会将图片发送至客户端
为了节省服务器的网络流量,生成的图片最多只能为1080P分辨率,如设置超过限制则会自动设回1080P分辨率

一个小功能

如果您忘记了API的调用地址,只记得api.xiaorin.com,没关系,我给根Uri做了个小页面用来导航
虽然导航页的页面简陋了点,但也不是不能用(

小提示

您在调用API时必须使用https协议,Nginx不会给您自动从http重定向到https
您如果使用http协议访问就会显示下图的错误
2025-03-20T09:44:08.png

请求示例

如果您想把它放在自己博客的侧边栏,可以这样调用:
高126,宽300,字号12
https://api.xiaorin.com/get_image?h=126&w=300&fs=12&lt=5&l=5&rdfs=8

效果

效果
当然,您也可以使用随机图片的API来当随机背景图片,就拿GTX690的随机猫娘乐园图片API来示例(API里套API)
https://api.xiaorin.com/get_image?bg=https://www.nekopara.uk/pic_api
如果您的随机图片API炸掉了,则会自动换回默认的背景图片

效果

效果2
如果您的背景太杂乱,可以更换字体颜色,或者实现js检测图片包含哪种颜色最多就换成它最显眼的文字颜色,这个功能就由你们自己去实现了

文字颜色更换效果(黑色)

效果3
这里有一个小坑,fc参数的16进制颜色代码不允许带"#",一旦带了就会显示如下错误:
2025-03-21T17:11:31.png

之后可能会添加的功能

  • 主题商店

这个得要搞一段时间才搓的出来,会比较久点