CatieAPI 是一个轻量、清爽、面向大众用户的 AI 聚合网关。它兼容 OpenAI 风格接口，但不要求用户记住复杂路径：Base URL 可以直接填写 https://shiliyuming.com，不用写 https://shiliyuming.com/v1。
目标是提供一个更轻、更清楚、更像 iOS 原生应用体验的模型网关。
- OpenAI-compatible Chat Completions
- Base URL 可直接填写域名，兼容省略
/v1 - Go + Gin 后端，一个服务托管 API 和前端
- Postgres / 文件持久化
- API Key 哈希存储，渠道上游 Key 可加密持久化
- 渠道故障切换，仅对连接错误、429 和上游 5xx 有限重试
- 后台可配置日志保留天数、日志和额度流水上限
- Discord OAuth 登录，可按服务器 ID 和身份组 ID 准入
- 1Panel / Docker 部署
- iOS 风格管理后台，支持浅色和暗色模式
curl http://localhost:8787/chat/completions \
-H "Authorization: Bearer cat_你的_api_key" \
-H "Content-Type: application/json" \
-d '{"model":"ds","messages":[{"role":"user","content":"hello"}]}'也兼容标准路径：
curl http://localhost:8787/v1/chat/completions \
-H "Authorization: Bearer cat_你的_api_key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6","messages":[{"role":"user","content":"hello"}]}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: "cat_你的_api_key",
baseURL: "https://shiliyuming.com"
});
const response = await client.chat.completions.create({
model: "ds",
messages: [{ role: "user", content: "hello" }]
});MIT License. Copyright (c) 2026 Catie.
- 网关转发：兼容 OpenAI 风格接口，统一转发到不同模型供应商。
- 渠道管理：配置供应商、模型、权重、优先级、故障切换。
- 用户管理：注册、登录、用户状态、角色权限、额度、封禁、备注。
- API Key 管理：创建、禁用、删除、权限范围、调用统计。
- 额度与消耗：管理员手动调整余额，按 Token 记录调用消耗和额度流水。
- 日志与审计：请求日志、错误日志、渠道健康状态。
- 管理后台：用户、渠道、模型、价格、系统配置。
- 文档中心：快速开始、API 参考、部署指南、常见问题。
- 不接支付网关，不提供充值、套餐或返利系统。
- 不做重型后台大屏。
- 不堆叠卡片和装饰元素。
- 不使用渐变色作为主视觉。
- 图标统一使用 SVG。
- 表单、列表、设置页采用 iOS 设置页式分组。
- 支持浅色和暗色模式，界面使用系统分组、材质、分段控件和开关。
npm install
go mod tidy
npm run dev默认地址：
- Web 控制台：http://localhost:5173
- Go API 服务：http://localhost:8787
- React 管理后台
- Go + Gin API 后端
- Go 生产环境托管前端
dist - Docker / 1Panel 部署配置
- iOS 风格浅色/暗色界面
- 分段控件、系统开关、玻璃材质导航、分组列表
- 移动端底部 Tab、移动列表布局、横向滑动快捷操作
- Live Gateway 面板、请求流转视图、快捷动作入口
- SVG 图标
- 用户管理
- Discord OAuth 登录
- 服务器 ID / 身份组 ID 准入
- API Key 展示、创建、启停
- 渠道管理
- OpenAI-compatible 上游转发
- compatible 模式 SSE 流式透传
- 渠道启停、模型启停
- 渠道级上游 Key 配置
- 调用日志
- 文件持久化：
data/state.json - Postgres 持久化：
PERSISTENCE=postgres - OpenAI compatible
/v1/chat/completions
测试网关：
curl http://localhost:8787/v1/chat/completions \
-H "Authorization: Bearer cat_你的_api_key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6","messages":[{"role":"user","content":"hello"}]}'也可以省略 /v1：
curl http://localhost:8787/chat/completions \
-H "Authorization: Bearer cat_你的_api_key" \
-H "Content-Type: application/json" \
-d '{"model":"ds","messages":[{"role":"user","content":"hello"}]}'