Skip to content

介绍

ZC API Gateway(zc-api)是一个统一的 AI API 网关。它把分散在各家厂商的大模型接口聚合到一起,对外提供 OpenAI 兼容的 HTTP API。

任何能对接 OpenAI、Anthropic、Gemini 协议的客户端、SDK、IDE 工具,都能直接接入本网关,不需要改代码。

为什么需要它

  • 一个 Token 调所有模型:不用在每家厂商分别开账号、管理 Key
  • 统一计费与额度:按 token / 次数计费,统一报表,避免各平台单独额度
  • 客户端 0 改造:网关对 /v1/chat/completions/v1/messages/v1beta 等多种协议格式做了适配
  • 安全边界:上游原始 Key 只放在网关侧,不暴露给最终用户
  • 限流 / 分组 / 负载均衡:可按用户、按渠道做策略

上游覆盖

聚合 37+ 上游供应商,包含但不限于:

类型供应商
海外闭源OpenAI、Anthropic Claude、Google Gemini、Azure OpenAI、AWS Bedrock
国内闭源阿里通义、百度文心、智谱 GLM、字节豆包、腾讯混元、Moonshot、DeepSeek、阶跃星辰、零一万物
多模态 / 媒体Midjourney、Suno、可灵、即梦、火山方舟视频
开源自托管Ollama、vLLM、任意 OpenAI 兼容服务

完整列表见 relay/channel/ 目录。

协议入口

协议路径前缀说明
OpenAI/v1/...Chat / Embeddings / Images / Audio / Files
Anthropic/v1/messagesClaude 原生格式
Gemini/v1beta/models/...Google 原生格式
Midjourney/mj/submit/...MJ 代理格式

同一个 Token 可以跨协议复用。例如配 Claude Code 用 Anthropic 入口,配 Codex 用 OpenAI 入口,背后是同一个账号、同一份额度。

谁在用

  • AI 应用研发:把多家模型抽象成一个后端依赖
  • IDE / 编码助手用户:在 Claude Code、Codex、Gemini CLI、OpenCode 中接入
  • 团队 / 工作室:统一发放子账号 Token,按部门或项目核算成本

下一步

基于 new-api 二次开发,AGPL-3.0 协议