AIClient-2-API 使用指南：快速接入 AI 模型
AIClient-2-API 模拟 Gemini CLI、Qwen Code 和 Kiro 客户端请求，兼容 OpenAI API。它支持每日数千次 Gemini 模型请求，并允许通过内置机制访问特定模型服务。可通过 API 轻松连接任何客户端，提高 AI 开发效率。
项目核心价值
AIClient-2-API 提供实际的技术价值，突破传统 AI 模型 API 的费用高昂和调用限制问题。通过智能协议转换机制，实现更高效的集成。
技术亮点：
- 多模型覆盖：支持 Claude 全系列、Gemini、Qwen 等主流模型
- 协议兼容：无论应用使用 OpenAI、Claude 还是 Gemini 协议，都能无缝接入
快速部署实战指南
环境准备阶段
git clone <repository_url>
cd AIClient-2-API
服务启动操作
根据你的操作系统选择相应启动方式：
- Linux/macOS 用户：执行
./install-and-run.sh - Windows 用户：运行
install-and-run.bat
管理界面访问
在浏览器中输入 http://localhost:3000，即可进入完整的管理控制台。
核心配置详解
认证文件获取方法： 客户端登录成功后，系统会在 ~/.aws/sso/cache/ 目录自动生成 kiro-auth-token.json 文件。
配置操作流程：
- 打开 Web UI 的配置管理页面
- 定位 OAuth 配置选项
- 上传或指定认证文件的具体路径
智能协议转换机制
AIClient-2-API 的核心功能在于其智能协议转换能力。系统内置的 ConverterFactory 能够：
- 将 OpenAI 消息格式转换为所需 API 格式
- 支持多模型间的请求适配
- 自动处理不同协议间的参数映射
实际调用端点示例：
- OpenAI 协议端点：
/claude-kiro-oauth/v1/chat/completions - Claude 协议端点：
/claude-kiro-oauth/v1/messages
高级功能特性
对于团队使用或高并发场景，提供了完整的账户池管理：
智能轮询机制：
- 自动健康检查功能
- 智能账户选择算法
- 实时故障检测与自动切换
性能监控体系
管理控制台提供全面的监控功能：
- 系统运行时间统计
- 内存使用情况监控
- 节点版本信息显示
- 服务器时间同步
实际应用场景
开发工具集成： 支持 Cherry-Studio、NextChat、Cline 等主流开发工具，以及自定义客户端接入和批量任务处理优化。
