官方 Skill，全功能支持
从模型、账号和路由配置，到请求诊断、额度管理和日常运维，Agent 通过官方 Skill 使用 SmartAPI 的完整管理能力。
安装官方 Skill →简体中文
OPEN SOURCE · SELF-HOSTED · AI GATEWAY
SmartAPI
自托管 AI 网关
接上你常用的客户端和已有账号。选路、等待、可恢复的故障，交给 SmartAPI 处理。
Go + SQLite · AMD64 / ARM64 · Apache-2.0
01 / AI FIRST
AI First
逻辑模型：对业务，不对上游
按业务定义模型入口。上游模型、账号和线路在 SmartAPI 内调整，业务端配置保持不变。
配置逻辑模型 →02 / PERFORMANCE
极致性能
内存占用更低
峰值内存工作集 30.8–34.5 MiB。在本次基准测试中，比 CLIProxyAPI 低约 49%–55%，比 sub2api 整套服务低约 92%–93%。
CPU 占用更低
SmartAPI 峰值 CPU 占用与 CLIProxyAPI 接近，低于 sub2api 整套服务：分别为 146.6%–157.1%、151.0%–151.2%、390.2%–406.3%。
同源基线测试，非 1.0.0 发行镜像重测：OpenAI Chat Mock · ARM64 · 并发 32 · 1 KiB / 64 KiB 响应 · 2026-10-30。 方法与完整数据 →
03 / RELIABILITY
可靠请求
故障自动切换
首选上游故障时，自动尝试兼容的备用线路。
切换策略自由配置
按时间窗口、首输出等待上限和失败类型等条件，配置何时等待、何时切换。
配置切换策略 →限流排队，少看 429
容量不足时按预算排队等待，容量释放后继续请求。
自动重置，额度保护
自动兑换可用的 Codex 重置券，结合配额保护，减少额度耗尽后的无效请求。
自动重置与额度保护 →TERMINAL
curl -fsSLo compose.yaml https://github.com/hulkbig/smartapi/releases/latest/download/compose.yaml
docker compose up -d --no-build打开 localhost:17910 完成初始化。
开始之前
SmartAPI 自带账号或额度吗？
不提供。你使用自己的 API Key 或受支持的订阅账号；调用、重试和探测可能产生费用。
会一直 Thinking 到成功吗？
等待有恢复预算。客户端显示 Thinking，不代表上游一直在推理，也不保证最终成功。
所有组合都验证过了吗？
没有。部分账号驱动只有离线测试；工具、流式和续轮要按你实际使用的线路验证。