📖 API 文档

🔑 认证

所有 API 请求需要在 Header 中携带 API Key。支持两种认证模式：

模式 1: 简单模式

Authorization: Bearer YOUR_PROXY_API_KEY
x-api-key: YOUR_PROXY_API_KEY

模式 2: 组合模式（多租户）✨ 推荐

Authorization: Bearer YOUR_PROXY_API_KEY:YOUR_REFRESH_TOKEN

模式 3: 托管 API Key

Authorization: Bearer kg-xxxxxxxxxxxxxxxx

通过管理面板创建的 API Key，支持额度限制和模型限制。

📡 端点列表

GET /v1/models 模型列表
POST /v1/chat/completions OpenAI 聊天补全
POST /v1/messages Anthropic Messages API
GET /health 健康检查

💡 使用示例

OpenAI SDK (Python)

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="YOUR_PROXY_API_KEY"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")

cURL

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer YOUR_PROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"Hello!"}]}'

🤖 可用模型

  • claude-opus-4-5
  • claude-sonnet-4-5
  • claude-sonnet-4
  • claude-haiku-4-5
  • claude-3-7-sonnet-20250219