README.md

metadata

title: CLI Proxy API Plus
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
short_description: 統一的 AI API 代理服務

🚀 CLI Proxy API Plus

統一的 AI API 代理服務，支援多種 AI 提供者，提供標準化的 OpenAI 兼容 API 接口。

✨ 功能特點

• 🔌 統一 API 接口 - OpenAI 兼容格式，無縫整合現有工具
• 🔐 OAuth 認證管理 - 支援多種 OAuth 認證流程
• 📊 使用量統計 - 實時監控 API 使用情況
• 🔄 自動 Token 刷新 - 智能管理認證憑證
• 🌐 多提供者支援 - Claude、OpenAI、Gemini、Copilot、Kiro 等
• 🎨 Streamlit Web UI - 友好的圖形化管理介面

🤖 支援的 AI 提供者

提供者	認證方式	模型
🟠 Claude	OAuth	claude-3-5-sonnet, claude-3-opus
🟢 OpenAI	API Key / OAuth	gpt-4o, gpt-4-turbo
🔵 Gemini	API Key	gemini-1.5-pro, gemini-1.5-flash
⚫ GitHub Copilot	OAuth	gpt-4, gpt-3.5-turbo
🟡 Kiro	OAuth / AWS	claude-3-5-sonnet (via AWS)
🟣 Codex	OAuth	gpt-4, gpt-3.5-turbo

🚀 快速開始

使用 Web UI

1. 訪問此 Space 的 URL
2. 在側邊欄查看 API 狀態
3. 使用以下功能：
   • 💬 Chat - 測試 API 請求
   • 🔑 Auth - 管理認證憑證
   • 📊 Stats - 查看使用統計
   • ⚙️ Settings - 配置系統

API 端點

# Chat Completions (OpenAI 兼容)
curl -X POST https://{your-space}.hf.space/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# 列出模型
curl https://{your-space}.hf.space/v1/models

🔐 配置 Secrets

在 Hugging Face Spaces 的 Settings > Secrets 中添加以下配置：

Secret 名稱	說明	範例
API_KEYS	API 訪問密鑰	["sk-xxx", "sk-yyy"]
MANAGEMENT_KEY	管理介面密鑰	your-admin-key
CLAUDE_TOKEN	Claude OAuth Token	(JSON 格式)
OPENAI_API_KEY	OpenAI API Key	sk-...
GEMINI_API_KEY	Gemini API Key	AIza...

📁 專案結構

hf-spaces/
├── Dockerfile           # Docker 構建文件
├── supervisord.conf     # 進程管理配置
├── entrypoint.sh        # 容器入口腳本
├── requirements.txt     # Python 依賴
├── README.md            # 本文件
├── DEPLOYMENT.md        # 詳細部署指南
├── CLIProxyAPIPlus      # Go 二進制（需預先構建）
└── streamlit_app/       # Streamlit 應用
    ├── app.py           # 主程序
    └── pages/
        ├── 1_💬_Chat.py    # API 測試頁面
        ├── 2_🔑_Auth.py    # 認證管理頁面
        ├── 3_📊_Stats.py   # 使用統計頁面
        └── 4_⚙️_Settings.py # 系統設定頁面

🔧 構建 Go 二進制

重要：部署前需要先構建 Go 二進制文件。

Linux/macOS

cd /path/to/CLIProxyAPIPlus
GOOS=linux GOARCH=amd64 go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/

Windows (PowerShell)

cd C:\path\to\CLIProxyAPIPlus
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o hf-spaces/CLIProxyAPIPlus ./cmd/server/

驗證構建

ls -la hf-spaces/CLIProxyAPIPlus
# 應該顯示一個約 20-30MB 的可執行文件

🏗️ 架構

┌─────────────────────────────────────────┐
│           Hugging Face Spaces            │
│  ┌─────────────────────────────────────┐ │
│  │          Docker Container           │ │
│  │  ┌─────────────┐  ┌──────────────┐  │ │
│  │  │  Streamlit  │  │  Go API      │  │ │
│  │  │  :7860      │  │  :8317       │  │ │
│  │  │  (前端UI)    │──│  (後端服務)   │  │ │
│  │  └─────────────┘  └──────────────┘  │ │
│  │         Supervisord 進程管理         │ │
│  └─────────────────────────────────────┘ │
└─────────────────────────────────────────┘
                    │
                    ▼
        ┌───────────────────────┐
        │    AI Provider APIs    │
        │  Claude/OpenAI/Gemini  │
        └───────────────────────┘

📖 使用說明

1. API 測試

1. 點擊左側 💬 Chat 頁面
2. 選擇 AI 提供者和模型
3. 輸入問題並發送請求
4. 查看響應結果

2. 認證管理

1. 點擊左側 🔑 Auth 頁面
2. 查看各提供者的認證狀態
3. 配置 OAuth 或 API Key

3. 查看統計

1. 點擊左側 📊 Stats 頁面
2. 查看請求量、Token 消耗等統計
3. 監控各提供者狀態

⚠️ 注意事項

1. 資源限制 - HF Spaces 免費版有 CPU 和內存限制
2. 存儲限制 - 容器重啟後數據會丟失
3. HTTPS - HF Spaces 強制使用 HTTPS
4. 並發限制 - 免費版並發請求有限制

🔗 相關連結

• GitHub 倉庫
• 原版文檔
• Hugging Face Spaces

📝 授權

本專案採用 MIT 授權條款。詳見 LICENSE 文件。

---

Made with ❤️ by CLIProxyAPI Plus Team