系统应用场景
Kdd API 作为 AI API 网关，核心定位是统一的 AI 能力接入与管控平台，主要服务于以下场景：
一、企业内部 AI 能力统一分发
企业通常需要同时使用多家 AI 厂商的服务（如 OpenAI 的对话模型、Claude 的长文本分析、Gemini 的多模态能力、国产模型的中文优势）。Kdd API 将 40+ 家提供商的接口统一封装为 OpenAI 兼容格式，业务方只需对接一套 API，即可透明访问所有厂商能力，无需逐一适配各家的接口差异、鉴权方式和数据格式。
二、API 商业化运营 / AI SaaS 平台
平台支持完整的用户体系（注册、登录、OAuth 第三方登录）、多级权限管理（普通用户 / 管理员 / 超级管理员），并提供灵活的计费能力——支持按量计费、阶梯定价、订阅制等多种模式，集成 Stripe、Epay 等支付渠道。运营方可以基于 Kdd API 快速搭建面向 C 端或 B 端的 AI 服务售卖平台，实现对下游用户的配额管理、用量统计和费用结算。
三、渠道管理与容灾调度
系统为每家 AI 厂商提供渠道化管理：可配置多个 API Key、自定义模型映射、请求头/参数覆写。当某个渠道出现限流、故障或余额不足时，智能调度策略会自动切换到可用渠道，结合亲和性缓存和跨组重试机制，保障业务连续性。对于需要高可用的生产环境，这种多通道冗余能力尤为关键。
四、成本与合规管控
内置的速率限制（全局 / 按模型 / 按用户 / 按 IP）、敏感词过滤、IP 白名单、用量日志审计等功能，使管理者能够精细化控制 AI 能力的消耗节奏，防止滥用和预算超支，满足企业合规与安全要求。
总而言之，Kdd API 适用于所有需要集中管理、分发和商业化多种 AI 模型服务的场景——从企业内部落地 AI 能力中台，到独立运营 AI SaaS 产品，均可一栈式支撑
功能介绍
Kdd API 围绕 AI API 的接入、分发、管控、运营四大维度，构建了完整的功能体系：
一、AI 提供商接入（Relay 中继引擎）
核心模块，支持 40+ 家 AI 厂商的协议适配。自动完成 OpenAI、Claude、Gemini 等格式间的双向请求转换，使下游客户端无需关心上游差异。覆盖对话补全、文本嵌入、重排序、图像生成、语音合成/识别、视频生成等全部 AI 能力类型。
二、用户与鉴权体系
提供完整的用户注册/登录、OAuth 社交登录（GitHub、Discord、微信等）、Passkey 无密码登录及 TOTP 双因素认证。支持三级角色（普通用户、管理员、超级管理员）的权限分级，以及 JWT + API Key 双轨鉴权模式。
三、渠道管理
将每个 AI 厂商实例抽象为"渠道"，支持多 Key 轮转、模型映射覆写、自定义请求头/参数注入、优先级权重配置。智能调度器结合亲和性缓存和跨组重试，实现自动故障切换与负载均衡。
四、计费与支付
内置灵活的计费表达式引擎，支持按 Token 阶梯定价、订阅制（日/周/月/自定义周期），集成 Stripe、Epay 等支付通道，实现预扣费-结算-补扣/退款的全生命周期管理。
五、速率与安全管控
提供全局/按模型/按用户/按 IP 的多级速率限制，敏感词过滤、SSRF 防护、IP 白名单、用量审计日志等安全能力，防止滥用并满足合规要求。
六、管理后台
双主题（默认 + 经典）Web 管理面板，提供仪表盘、用户管理、Token 管理、渠道配置、日志查询、数据统计可视化等全功能操作界面，并支持中/英/法/俄/日/越多语言切换。
一、项目架构与技术栈
项目采用严格的分层架构：Router → Controller → Service → Model。
后端技术栈：Go 1.25+ 作为核心语言，Gin 作为 HTTP 框架，GORM v2 作为 ORM 层，同时兼容 SQLite、MySQL（≥5.7.8）和 PostgreSQL（≥9.6）三种数据库，Redis 提供缓存与分布式限流。计费方面集成了 Stripe、Epay 等多种支付渠道。
主题采用 React 19 + TypeScript + Rsbuild + Base UI + Tailwind CSS 4 的技术组合使用 i18next 国际化方案。
中继适配器模式：核心亮点是提供商适配层。channel.Adaptor 接口定义了统一的适配器契约（请求转换、响应解析、模型列表获取等），37 个提供商子目录各自实现该接口。工厂函数 GetAdaptor() 通过 API 类型映射到具体适配器。支持 OpenAI ↔ Claude ↔ Gemini 格式之间的双向请求转换。
二、实现亮点与难点
亮点：
- 计费表达式引擎：基于 expr-lang/expr 实现了图灵完备的动态计费系统，支持分层定价、条件乘数、时间函数等。通过 AST 自省实现自动化的 Token 归一化，避免缓存 Token、音频 Token 等子类别的重复计数。
- 智能渠道调度：渠道选择算法结合权重随机、亲和性缓存、跨组重试等策略，在保证可用性的前提下实现负载均衡与成本优化。
难点：
- 三数据库兼容：所有数据操作需同时适配 SQLite、MySQL、PostgreSQL 三种差异显著的数据库。
- 异步任务轮询体系：视频生成、音乐生成等异步任务平台需要统一的轮询适配器，同时处理预扣费、结算补扣/退款的生命周期管理。
声明：本文仅代表作者观点，不代表本站立场。如果侵犯到您的合法权益，请联系我们删除侵权资源！如果遇到资源链接失效，请您通过评论或工单的方式通知管理员。未经允许，不得转载，本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态
评论