两件东西:Python SDK(litellm.completion() 一个接口调各家模型)和可自托管的 Proxy 网关(虚拟 Key、预算、限流、fallback、用量统计)。即便用户已经用本站做路由,LiteLLM 的「按模型分工 + 失败切换」思路和本地调试代理依然很实用。
适用场景:一个项目里要混用多家/多档模型、想在客户端一侧做 fallback 和成本统计、或给团队内部再套一层虚拟 Key。
litellm proxy gateway multi-model fallback cost
操作步骤
- 只做 SDK:
pip install litellm,用completion(model="openai/your-model-id", api_base="https://tokenbuddy.cc/v1", api_key=...)。 - 要做网关:用官方 Docker 镜像 +
config.yaml写 model_list,锁定版本号(见 pitfalls 的供应链事件)。 - 给每个应用/Agent 发独立虚拟 Key 并设
max_budget,出问题能单独吊销。
代码示例
from litellm import completion
r = completion(model="openai/your-model-id",
api_base="https://tokenbuddy.cc/v1",
api_key="{{API_KEY}}",
messages=[{"role": "user", "content": "Hi"}])
print(r.choices[0].message.content)开源项目信息
- 仓库:https://github.com/BerriAI/litellm
- Stars 口径:来源分歧较大——该 gist 称约 89k、另有文章称约 59k、还有来源称 2026-10-23 约 61.8k,不填报单一数字,以 GitHub 实时为准
- 许可:核心 MIT(来源明示,企业版功能另行授权)
接入本站 API:把本站当作 LiteLLM 的一个 OpenAI 兼容上游即可;不要在本站路由之上再无脑叠一层重试,两层重试叠加会把 429 放大成重试风暴。
注意事项
- ⚠️ 默认重试参数可能让故障时每请求先耗数秒才 fallback,上线前调 num_retries
- ⚠️ 历史上有过 PyPI 恶意版本事件(来源提及 1.82.7/1.82.8),务必锁版本、优先官方镜像
- ⚠️ 网关不是必需品——单应用直调本站更简单
来源:https://gist.github.com/Laurian/43296129324d3497d74c198cafa74068