接入指南¶

通过 Serevix AI 网关，你可以在 Claude Code、Cursor、OpenCode 等主流 AI 工具中复用同一个 API Key 调用 Claude / GPT / Gemini 等大模型；也可在自研代码中用兼容协议直接调用。本页聚焦工具接入，API 协议细节请见左侧文档目录。

1. 创建 API Key 与基础信息¶

请前往 Serevix AI 控制台创建 API Key（无需提交申请）。如需更高额度或技术支持，可联系 aisupport@serevixai.com。

项	值
Base URL	`https://gateway.serevixai.ai`
OpenAI 兼容路径	`https://gateway.serevixai.ai/v1`
鉴权方式	`Authorization: Bearer YOUR_API_KEY`

2. 在 IDE / 助手中接入¶

2.1 Claude Code¶

Claude Code 会自动读取 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量，无需额外配置。在终端中执行：

export ANTHROPIC_BASE_URL=https://gateway.serevixai.ai
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
claude

如需常驻，请将上述 export 写入 ~/.zshrc 或 ~/.bashrc。

2.2 Cursor¶

Cursor 走 OpenAI 兼容协议，Base URL 必须以 /v1 结尾。

打开 Cursor → Settings → Models
在 OpenAI API Key 字段填入你的 API Key
展开 Override OpenAI Base URL，填入：https://gateway.serevixai.ai/v1
在模型列表中按需添加要使用的模型 ID（例如 gpt-4o-mini、claude-sonnet-4-6 等，可参考模型广场）
点击 Verify / Save 完成

2.3 OpenCode¶

OpenCode 使用配置文件 ~/.config/opencode/opencode.json（Windows 在 C:\Users\<用户名>\.config\opencode\opencode.json）。在 provider 下覆盖各协议的 baseURL，然后通过 opencode auth login 为每个 provider 录入同一个 API Key（OpenCode 不在配置文件里保存 Key）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "name": "Anthropic",
      "options": {
        "baseURL": "https://gateway.serevixai.ai"
      }
    },
    "openai": {
      "name": "OpenAI",
      "options": {
        "baseURL": "https://gateway.serevixai.ai/v1"
      }
    },
    "gateway": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Serevix AI Gateway",
      "options": {
        "baseURL": "https://gateway.serevixai.ai/v1"
      }
    }
  }
}

anthropic：Claude 系列走 Anthropic Messages 原生协议
openai：GPT 系列走 OpenAI 兼容协议
gateway：通过 @ai-sdk/openai-compatible 接入其它厂商模型（Gemini / DeepSeek / 文心一言等），可在该块下加 models 字段显式声明模型 ID，模型清单见模型广场

3. 支持的模型¶

实时支持的模型清单与价格请见模型广场。

4. 直接调用 API¶

如果不使用 IDE 助手，而是在自研服务中调用，请按需进入对应协议页：

5. 常见问题¶

5.1 与直接调用厂商官方 API 有什么差异？¶

Serevix AI 网关完全兼容 OpenAI、Anthropic、Gemini 等上游协议，原有代码无需任何修改即可切换。差异在于网关层提供多账户轮换、负载均衡和限流保护，整体可用性和抗压能力优于单账号直连。

5.2 是否支持流式输出（Streaming）？¶

支持。OpenAI、Anthropic、Gemini 等所有支持流式的模型都已开放，使用方式与各自官方 API 完全一致，无需额外参数。

5.3 一个 API Key 能在多个项目中使用吗？¶

可以。一个 API Key 不限制项目数量与并发场景，Claude Code、Cursor、自研后端可以同时复用同一个 Key。如需做调用来源隔离或额度拆分，建议申请多个 Key。

5.4 API Key 泄露了怎么办？¶

请立即登录 Serevix AI 控制台，删除已泄露的 API Key 并创建一个新的 Key。删除后该 Key 会立即失效，建议同步更新所有正在调用该 Key 的服务。

5.5 如何申请更多模型权限或技术支持？¶

请联系 Serevix AI 支持团队：aisupport@serevixai.com