2026 更新:本项目迎来了全新的 v2.0 大版本重构!彻底干掉了 Chromium 和 Puppeteer,换上了 Google Skia 原生 2D 图形内核,速度提升超 150 倍,并加入了入场动图导出与纯矢量 SVG 输出。文章内容已全面同步更新~
项目地址
- Github:https://github.com/sf-yuzifu/ba-logo-api
- WebUI 控制台:https://api.yuzifu.top/(Kivotos HUD 风格仪表盘)
- Swagger 接口调试:https://api.yuzifu.top/swagger
- 接口演示:https://api.yuzifu.top/api/logo?left=Blue&right=Archive
关于公共调用:之前在 1.0 时写过“不建议直接调用,随时可能挂掉”,那是因为以前用无头浏览器 Puppeteer 截图,动不动就吃光几百 MB 内存导致小机器 OOM 挂掉(笑)。现在 2.0 换成了轻量高效的 Skia 引擎,常驻内存仅 30~50MB,服务稳定得多,大家可以放心轻度调用。不过如果有大量请求或长期业务需求,依然强烈建议自己部署一个~
为什么推倒重构?(v2.0 升级背景)
最初做这个 API 的时候,为了图省事,底层是直接通过 Puppeteer 启动一个 Headless Chromium,把 HTML/Canvas 页面渲染出来然后截图返回。
虽然能跑,但用无头浏览器当图片渲染服务简直是“高射炮打蚊子”:
- 慢:Chromium 启动和页面加载非常沉重,单张图渲染延迟长达 1.5s ~ 2s 以上;
- 太吃内存:一个无头 Chromium 进程动辄吃掉数百 MB 甚至上 G 内存,小内存 VPS 经常一碰就 OOM 宕机;
- 体积臃肿:原先的 Docker 镜像动辄好几百 MB 甚至上 GB,拉取部署都很折磨;
- 字体与兼容性问题:原先字体不全,遇到罕见字或日韩文字很容易缺字变成“豆腐块”。
于是这次下定决心彻底推翻重写,放弃无头浏览器,拥抱现代原生技术栈:Bun + Elysia + Google Skia 原生 2D 绘图引擎(@napi-rs/canvas)。
v2.0 核心特性
- ⚡ 极致性能跃迁:基于底层 C++/Rust 编译的 Google Skia 原生图形内核,单图生成延迟从约 2000ms 骤降至 8~15ms,提速超过 150 倍!
- 🪶 超低资源占用:常驻内存仅 30~50 MB RSS,JS 堆内存维持在 20MB 以内,几十块钱的 1C1G 入门级小主机也能流畅抗并发。
- 🎬 入场动图生成(GIF / APNG / 动态 SVG / 动态 WebP):还原了游戏 Logo 经典的入场动效——左右文字从两侧靠拢,左侧自上而下染色、右侧自下而上染色;十字从中心向外延伸,光环与副标题随之展开。
- 🎨 免字体的纯矢量 SVG 直接导出 (
format=svg):通过 Skia 将所有字形轮廓提取转换为矢量 Path,配合<mask id="...">矢量镂空算法,输出完全不依赖任何客户端字体的纯矢量 SVG,可以无限无损缩放,直接拖入 Figma、Illustrator 或 Inkscape 进行二次排版! - 🌐 全量 30,000+ CJK 字形库:内置经过精心合并微调的超大字形库(约 9MB,常驻内存),完整覆盖拉丁字母、日文假名、简体中文、繁体中文及韩文谚文,再也不会出现缺字或字体风格割裂。
- 🎛️ Kivotos HUD 控制台:基于 Vue 3 + Vite 定制打造的蔚蓝档案风格战术仪表盘前端,支持实时防抖预览、中英日韩多语言切换、移动端吸顶操作栏以及一键生成分享直链与复制图片。
- 🔄 平滑向下兼容:接口全面升级为 RESTful 规范(
GET /api/logo),而原先的GET /balogo接口会自动发起 HTTP 308 永久重定向并透传全部别名参数,之前的调用链接完全不受影响。
样例展示
| 官方本地化样式 (2x,带副标题) | 暗黑模式 (2x) |
|---|---|
![]() | ![]() |
| 赤红档案 · 颜色对调与自选主色 (2x) | 透明背景镂空裁切 (2x) |
![]() | ![]() |
| 入场动效 (GIF, 24fps) | 其他动态格式 |
![]() | 支持导出动态 WebP 与 SMIL 动态 SVG |
参数解释
现代 RESTful 接口推荐使用:GET /api/logo (旧版接口 GET /balogo 自动 308 重定向兼容)。
为了方便快速调用,参数均支持简写别名(如 l 对应 left,r 对应 right):
| 参数名 | 别名 | 类型 | 默认值 | 说明与示例 |
|---|---|---|---|---|
left | l | string | "蔚蓝" | 左侧主文字(主强调色,如 "Blue") |
right | r | string | "档案" | 右侧主文字(次要文字颜色,如 "Archive") |
subtitle | sub | string | "" | 可选副标题(右下方倾斜对齐,如 "ブルーアーカイブ") |
subtitleFontSize | subSize | number | 24 | 副标题基础字号(范围 12–96,会随 scale 缩放) |
offsetX | x | number | -15 | 光环与十字 X 轴偏移量(值越小越左移) |
offsetY | y | number | 0 | 光环与十字 Y 轴偏移量(值越小越上移) |
wordGap | gap | number | 0 | 左右两词间的距离微调(像素,范围 -100 ~ 300) |
transparent | tp | boolean | false | 背景是否透明(开启后文字与图元将执行矢量镂空切除) |
darkMode | dark | boolean | false | 是否开启暗黑模式(深灰底、白字) |
swapColors | swap | boolean | false | 是否对调左右文字主题颜色(左黑右蓝) |
accentColor | accent | string | "#128AFA" | 主强调色 Hex(影响左文字与十字架) |
textColor | color / tc | string | "#2B2B2B" | 主文字颜色 Hex(影响右文字与光环,暗黑模式默认为白) |
scale | s | number | 1 | 分辨率放大倍率(支持 0.1 ~ 8.0,2 即为 2x 高清大图) |
format | - | string | "png" | 导出格式:png, webp, jpeg, svg, gif, apng, svg-animated, webp-animated, base64 |
fps | - | number | 24 | 动图帧率(针对 gif / apng / webp-animated,范围 10~30) |
duration | - | number | 1.1 | 动图入场时长秒数(范围 0.4~3.0) |
padding | pad | string/number | 自动 | 内容留白边距(支持纯数字或 CSS 语法,如 "10 20") |
注:更进阶的图元控制(如十字独立颜色 crossColor、光环独立颜色 haloColor、图层置底 motifsBehindText、各方向独立 padding 等),可以在 /swagger 在线文档中查看与交互调试。
调用示例
1. 基础调用与高清放大
直接拼接 URL 即可在网页、聊天机器人或 Markdown 中使用:
2. 携带官方风格副标题
3. 暗黑模式 + 颜色对调(赤红风格)
4. 获取免字体纯矢量 SVG(适合导入设计软件)
只需要加上 format=svg,生成的 SVG 将所有文字都转为了 Path,无需在电脑上预装字体,无损缩放到多大都可以:
<img src="https://api.yuzifu.top/api/logo?left=Blue&right=Archive&format=svg" />5. 生成入场动图 (GIF)
自己部署
如果想要在自己的服务器上私有化运行,现在部署变得极为轻松,再也不用配置复杂的无头 Chromium 依赖环境了。
项目提供了基于多阶段构建的 Docker 镜像,体积仅有 ~90MB 左右:
# docker-compose.ymlservices: ba-logo-api: image: ghcr.io/sf-yuzifu/ba-logo-api:latest container_name: ba-logo-api restart: always ports: - "3000:3000"一行命令即可启动:
docker compose up -d启动完成后,访问 http://你的IP:3000/ 即可看到 Kivotos HUD 仪表盘,访问 http://你的IP:3000/swagger 即可查看 Swagger 文档。
视频介绍
这里保留了当初 1.0 时制作的视频介绍,留作纪念:
在线演示
可以在下方直接输入参数进行实时生成与体验,也可以直接点击下载或复制 API 链接:






