Aestus

Aestus

AI 模型网关:统一管理上游账号资源,对外提供标准 API

功能

• 统一 API:对外提供 OpenAI / Anthropic 风格接口
• 图片 API:提供 OpenAI 风格 /v1/images/generations 和 /v1/images/edits
• 搜索 API:代理 Codex standalone search /v1/alpha/search
• 资源池:自动调度与维护多个上游账号、Api Key
• 插件:内置codex -> responses兼容转换插件
• SaaS 租户:平台管理员分发明文租户码；首位注册者成为租户 owner，后续注册者成为普通用户
• 面板:平台管理员管理租户；租户 owner 管理本租户用户、网关 Api Key、账号、分组、插件和额度
• 用户并发:租户 owner 可设置并查看用户的每 Provider 并发，GPT 与 Claude 独立计数
• 分组授权:租户 owner 按 Provider 分组授权普通用户创建 Key，并可独立授予组内账号、 官方 Key、额度、重置信息和请求覆盖的查看或操作权限
• 租户隔离:租户名直接作为 tenant_id，所有租户资源、请求日志和用量统计按该可读标识隔离

技术栈

类别	技术
后端	Rust（axum）
存储	PostgreSQL / Redis / ClickHouse
插件	WebAssembly
前端	React
部署	Podman Compose

架构特点

• 所有上游共用一条处理流水线,差异由适配层实现,易复用易扩展
• 请求智能调度资源,粘性会话保证cache hit,失败自动换资源重试
• 热插拔wasm插件,灵活修改请求与响应
• 请求全链路可追踪,各阶段事件写入时序日志,高性能统计
• 大请求缓存到文件,降低内存峰值
• 用户请求通过 Redis 可续租 lease 做原子并发准入，覆盖上传、上游处理和流式响应生命周期

SaaS 租户与角色

• platform_admin 由启动配置初始化，管理租户生命周期、租户码，可只读查看各租户的上游账号与官方 API Key 资源，并可查看平台级请求日志和用量。
• tenant_owner 是某个租户第一位使用有效租户码完成注册的用户。owner 可以管理本租户全部上游资源、分组、插件、普通用户和 API Key，并查看本租户所有用户的请求日志与用量。
• tenant_user 只能管理自己的 API Key，并查看自己的请求日志与用量。用户只能选择 owner 已授权且启用的 Provider 分组；撤销分组授权后，该用户绑定此组的既有 Key 立即停止鉴权。
• owner 可以按分组额外授予普通用户查看组内 OAuth 账号或脱敏官方 API Key、查询 GPT 额度、查看或使用额度重置、查看或修改请求覆盖的权限。资源可视是所有细粒度权限的前置； 上游资源的导入、换组、启停、删除及 Provider 分组管理始终仅限 owner。
• 租户码以明文保存在 PostgreSQL。平台管理员可替换租户码；删除对应记录即撤销，已经注册的用户不受影响。
• 每个租户最多一个 owner。租户停用后，该租户 Dashboard 登录态和所有网关 API Key 都不可用。

快速开始

# 本地快速启动
make dev
# 部署
cd deploy && cp .env.example .env
podman compose up -d
# 旧compose版本可能会启动失败（容器依赖问题）
# 可以分开启动
podman compose up -d clickhouse redis postgres
podman compose run --rm --no-deps migrate
podman compose up -d gateway

图片 API

`POST /v1/images/generations` 和 `POST /v1/images/edits` 进入与 Responses 相同的鉴权、 模型白名单、资源调度、重试、maintenance、额度和请求日志流程。当前公开的是所有 GPT 资源都能一致执行的 buffe