接入文档

① 获取 API Key

登录控制台 → 「子 Key」→ 新增，即可拿到形如 sk-user-xxxxxxxx 的调用密钥（按通道自动路由到可用上游）。

② 调用示例（OpenAI 兼容）

# curl
curl https://你的域名/v1/chat/completions \
  -H "Authorization: Bearer sk-user-你的子Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "任意名称（网关自动路由）",
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'

# Python (openai SDK)
from openai import OpenAI
client = OpenAI(api_key="sk-user-你的子Key", base_url="https://你的域名/v1")
resp = client.chat.completions.create(
    model="任意名称",
    messages=[{"role":"user","content":"你好"}]
)
print(resp.choices[0].message.content)

③ 支持的端点

端点	协议	说明
POST /v1/chat/completions	OpenAI	对话补全（支持流式）
POST /v1/messages	Anthropic	Claude 原生格式，Claude Code 可直连
POST /v1/embeddings	OpenAI	向量嵌入
POST /v1/completions	OpenAI	传统补全
GET /v1/models	OpenAI	模型列表

💡 模型名由网关按通道策略决定，客户端传的 model 会被路由层接管。

Q：返回 402 Quota exceeded？

子 Key 的 Token 配额用尽。到控制台「子 Key」查看用量，或联系管理员调整上限。

Q：返回 403 MODEL_NOT_ALLOWED？

该子 Key 配置了模型白名单，请求的模型不在白名单内。

Q：流式输出为空？

多为 max_tokens 设得过小（推理模型的思考 token 吃光了额度），调大即可。

Q：请求被降级（gateway_status=SWITCHED）？

首选上游异常（限流/超时），网关已自动切换到备用上游，属于正常容灾，不计额外费用。

如需开通账号或提升额度，请联系管理员。