README.md

metadata

title: Oh My API
emoji: 🐾
colorFrom: pink
colorTo: purple
sdk: docker
pinned: true
license: mit

 ██████╗ ██╗  ██╗      ███╗   ███╗██╗   ██╗      █████╗ ██████╗ ██╗
██╔═══██╗██║  ██║      ████╗ ████║╚██╗ ██╔╝     ██╔══██╗██╔══██╗██║
██║   ██║███████║      ██╔████╔██║ ╚████╔╝      ███████║██████╔╝██║
██║   ██║██╔══██║      ██║╚██╔╝██║  ╚██╔╝       ██╔══██║██╔═══╝ ██║
╚██████╔╝██║  ██║      ██║ ╚═╝ ██║   ██║        ██║  ██║██║     ██║
 ╚═════╝ ╚═╝  ╚═╝      ╚═╝     ╚═╝   ╚═╝        ╚═╝  ╚═╝╚═╝     ╚═╝

统一 AI API 代理网关

一个运行在 HuggingFace Space 上的高性能 AI API 代理，
统一接入 Claude · Gemini · OpenAI · Codex · Vertex AI

---

⚡ 支持的模型

提供商	支持模型	接入方式
🟣 Anthropic Claude	Claude 4.5 / 4.6 全系列	API Key
🔵 Google Gemini	Gemini 3.1 Pro / Flash	API Key
🟢 OpenAI	GPT-5.1 / GPT-5.2	API Key
🟡 Vertex AI	Gemini on Vertex	服务账号
⚪ OpenAI-compat	任意兼容 OpenAI 格式的服务	API Key

---

🚀 快速接入

将你的 API Base URL 替换为本 Space 地址即可：

# 原始请求
curl https://api.anthropic.com/v1/messages ...

# 替换为本代理
curl https://ohmyapi-2api.hf.space/v1/messages \
  -H "x-api-key: 你的访问密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-4-6-sonnet", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Python 示例

import anthropic

client = anthropic.Anthropic(
    api_key="你的访问密钥",
    base_url="https://ohmyapi-2api.hf.space",
)

message = client.messages.create(
    model="claude-4-6-sonnet",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好！"}]
)
print(message.content)

OpenAI SDK 兼容

from openai import OpenAI

client = OpenAI(
    api_key="你的访问密钥",
    base_url="https://ohmyapi-2api.hf.space/openai",
)

response = client.chat.completions.create(
    model="gpt-5.1",
    messages=[{"role": "user", "content": "你好！"}]
)

---

🏗️ 技术架构

┌─────────────────────────────────────────────────────┐
│                HuggingFace Space                     │
│                                                     │
│   Client Request                                    │
│        │                                            │
│        ▼                                            │
│   ┌─────────────┐        ┌──────────────────────┐   │
│   │             │        │   Supabase PostgreSQL │   │
│   │ CLIProxyAPI │◄──────►│   Token Store         │   │
│   │  :7860      │        │   Config Store        │   │
│   │             │        └──────────────────────┘   │
│   └──────┬──────┘                                   │
│          │                                          │
└──────────┼──────────────────────────────────────────┘
           │
    ┌──────┴───────┐
    │              │
    ▼              ▼
 Anthropic      Google
 Claude API     Gemini API

---

⚙️ 部署配置

必需环境变量

在 HuggingFace Space Settings → Secrets 中配置：

变量名	说明	示例
PGSTORE_DSN	PostgreSQL 连接字符串	postgresql://user:pass@host:6543/postgres?default_query_exec_mode=simple_protocol
MANAGEMENT_PASSWORD	管理后台密码	your-secure-password

🔑 添加 API Key

服务启动后，通过管理接口添加你的 API Key：

# 添加 Claude Key
curl -X POST https://ohmyapi-2api.hf.space/management/clients \
  -H "Authorization: Bearer $MANAGEMENT_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-client",
    "claude-keys": ["sk-ant-api03-xxxxx"]
  }'

# 添加 Gemini Key  
curl -X POST https://ohmyapi-2api.hf.space/management/clients \
  -H "Authorization: Bearer $MANAGEMENT_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-client",
    "gemini-keys": ["AIzaSy-xxxxx"]
  }'

---

Built with ❤️ · Powered by CLIProxyAPI · Hosted on HuggingFace