项目介绍

概述

Code Router 是一个统一的、兼容 OpenAI 的 AI 网关（API 中转/聚合层）。它把多家模型服务提供商收敛到一套接口之后：你只需要一个 API Key + 一个 Base URL，就能调用接入的多个上游模型，无需为每家提供商单独维护凭据和地址。

Code Router 支持自托管部署，适用于自用、团队内部以及企业私有化等合法授权场景。

核心特性

• 统一接口：兼容 OpenAI 标准格式，提供单一 API 入口与 Base URL，便于在现有 SDK / 客户端中直接接入
• 多提供商接入：在合法授权的上游账号与服务范围内，聚合多家模型服务（具体可用提供商与模型以你的部署配置为准）
• 模型分组（Model Groups）：将上游模型组织为分组，统一对外暴露逻辑模型名，便于路由与切换
• 令牌分组（Token Groups）：为不同 API Key 分配不同的可用模型范围与权限
• 配额与限额：对调用进行额度（quota）管理与限制
• 用量追踪：记录调用与消耗，提供用量统计与查询

一个 Key,一个 Base URL

接入方只需把请求指向 Code Router 的兼容端点,并使用分配到的 API Key:

curl https://ai.sammier.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

适用场景

• 个人或团队需要一个统一入口来调用多家模型服务
• 在组织内分发受控的 API Key,并对模型访问范围、配额与用量进行管理
• 私有化 / 自托管部署,数据与凭据留在自有环境内

许可证

Code Router 基于成熟的开源 AI 网关项目二次开发,沿用其开源许可条款。

要点:

• 在遵守开源许可证的前提下,可自由使用、修改与分发
• 如以网络服务（SaaS）形式部署修改后的版本,通常需要按许可证要求提供对应源代码 —— 以仓库内 LICENSE 原文为准
• 完整、具有法律效力的条款以 LICENSE 文档为准;本页仅作概述

反馈与贡献

• 问题反馈与功能建议:请在源码仓库提交 Issue —— GitHub Issues
• 代码贡献:欢迎通过仓库的 Pull Request 参与;贡献默认在项目许可证下授权

免责声明

1. 合法授权与合规使用

用户必须合法取得上游 API Key、模型服务及其他第三方服务的授权,并遵守上游服务条款与平台规则。使用本项目时,应确保相关场景符合适用的法律法规、监管要求与内容安全要求。

2. AI 提供商服务条款

用户必须遵守所有适用的 AI 提供商服务条款与协议(以各提供商官方条款为准)。

3. 学习与研究用途

本项目可用于个人学习、研究与内部使用。不对稳定性作任何保证,在开源许可证下可能不提供官方技术支持。

4. 合规义务

如用户面向不特定公众提供生成式 AI 服务,应自行完成所在地法律法规要求的备案、内容安全、身份管理、日志留存、税务、支付、消费者保护及上游授权等合规义务。

5. 地方法律法规

用户有责任确保遵守适用于其司法管辖区与使用场景的所有地方、国家及国际法律法规。