Orchids-2api (orchids-api) 是一个 Go 语言编写的 API 代理服务器,提供多账号管理与负载均衡代理功能,兼容 Claude API 格式的请求转发。
- 多账号管理与负载均衡代理
- 兼容 Claude API 格式的请求转发
- 将请求代理到 Orchids 后端服务
- 提供 Web 管理界面
- 支持多种 AI 模型
| 模型 | 提供商 | 描述 |
|---|---|---|
| Gemini 3 Flash | 快速高效的 Gemini 模型 | |
| Claude Opus 4.5 | Anthropic | Anthropic 最强大的 Claude 模型 |
| Claude Sonnet 4.5 | Anthropic | 均衡的 Claude 模型 |
| GPT-5.2 Codex | OpenAI | OpenAI 高级代码生成模型 |
| 文档 | 描述 |
|---|---|
| 架构设计 | 目录结构、核心组件、请求流程、数据模型 |
| API 接口 | 所有端点列表、请求/响应格式、认证说明 |
| 部署指南 | Docker 构建、本地开发、生产部署 |
| 配置说明 | 环境变量、配置文件格式 |
# 本地开发
go mod download
go run ./cmd/server/main.go
# Docker 部署
./build.sh
docker compose up -d- 多账号管理 - 支持添加、编辑、删除多个 Orchids 账号
- 多策略负载均衡 - 支持加权随机、轮询、最少连接三种策略
- 故障转移 - 账号失败时自动切换
- 健康检查 - 自动追踪账号健康状态,排除不健康账号
- 速率限制 - 每账号请求速率限制保护
- 多模型支持 - 支持 Gemini 3 Flash、Claude Opus 4.5、Claude Sonnet 4.5、GPT-5.2 Codex
- 模型别名 - 透明映射常用模型名称到实际模型
- 模型列表 API - OpenAI 兼容的 /v1/models 端点
- 工具调用 - 完整支持 Claude Tool Use
- 流式响应 - SSE 实时响应
- Token 计数 - 估算输入/输出 Token
- 调试日志 - 详细的请求/响应日志
- 管理界面 - Web UI 管理账号
- 导入导出 - 账号配置备份恢复
GET /v1/models- 获取可用模型列表POST /v1/messages- Claude API 代理端点GET /health- 健康检查
GET /api/loadbalancer/stats- 获取负载均衡器统计GET /api/loadbalancer/health- 获取账号健康状态PUT /api/loadbalancer/strategy- 设置负载均衡策略
详细 API 文档请参阅 API 接口。