使用教程

② 接口地址

FullBlood AI 同时兼容 Anthropic 和 OpenAI 协议。根据你要用的客户端，选对应的 base URL 和 endpoint：

Anthropic 协议

Base URL

https://fallbackp.top

Messages

POST /v1/messages

认证头

x-api-key: sk-xxx

推荐模型

claude-sonnet-4-7 / claude-opus-4-7

OpenAI 协议

Base URL

https://fallbackp.top/v1

Responses

POST /v1/responses

认证头

Authorization: Bearer sk-xxx

推荐模型

gpt-5 / gpt-5.5

不同密钥的权限分组决定能调哪些模型。如果调某个模型 403，去控制台查看密钥的可用模型范围。

③ Windsurf 插件接入

Windsurf 自带的 Cascade 走 Codeium 协议，需要装 wf-relay-vsix 插件做协议转发。

下载 vsix

访问 https://fallbackp.top/extension/wf-relay-vsix-0.1.7.vsix 下载最新插件。

在 Windsurf 中安装

Windsurf 左侧扩展面板 → 右上角 … → Install from VSIX... → 选刚下的 .vsix 文件。安装后重启 Windsurf。

打开插件面板填配置

命令面板 Ctrl+Shift+P → 输入 WF Relay: Open Panel。在面板里：

API Key：粘贴你的 sk-xxx
Default Model：选 claude-sonnet-4-7 或 gpt-5.5
Force Default Model：建议开启，防止 Cascade 把请求路由到其它模型

启动代理 + 测试

面板顶部 Start 启动 hybrid-server。Cascade 发条消息试试，控制台日志看到 ⚡ GetChatMessage → API 即代表生效。

插件会接管 Codeium 流量，所以登录态 / Marketplace 这些都还能用，只有 AI 请求被转发到 FullBlood。

④ Claude Code CLI 接入

官方 claude 命令行工具。两个环境变量就能切换到 FullBlood：

macOS / Linux

Windows PowerShell

export ANTHROPIC_BASE_URL="https://fallbackp.top"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-7"

claude   # 启动

持久化：把上面 3 条 export 写到 ~/.zshrc / ~/.bashrc。

$env:ANTHROPIC_BASE_URL = "https://fallbackp.top"
$env:ANTHROPIC_API_KEY  = "sk-xxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL    = "claude-sonnet-4-7"

claude   # 启动

持久化：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://fallbackp.top","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-xxxxxxxxxxxxxxxx","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","claude-sonnet-4-7","User")

未安装 Claude Code 的话：npm i -g @anthropic-ai/claude-code

⑤ Aider 接入

Aider 是终端里的 pair programming 工具。支持直接走 Anthropic 协议：

用 Claude

用 GPT

export ANTHROPIC_API_BASE="https://fallbackp.top"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxx"

aider --model anthropic/claude-sonnet-4-7

export OPENAI_API_BASE="https://fallbackp.top/v1"
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

aider --model openai/gpt-5.5

持久化：在项目根目录建 .env 写入上面这几行，Aider 会自动读取。

未安装 Aider：pip install aider-chat 或 pipx install aider-chat

⑥ 常见问题

401 / 认证失败

密钥被吊销或填错。回控制台 API 密钥 检查状态，重新复制粘贴。注意去掉首尾空格。

403 / 模型不允许

当前密钥所在分组不包含该模型。换一个分组的密钥，或在控制台升级套餐。

429 / 限流

触发了速率限制。稍等几秒再试，或升级到更高额度套餐。

插件没截到请求

检查面板里 Start 是否开启、状态栏是否显示 hybrid-server 已启动。Windsurf 重启一次。

余额不足

调用前 /v1/messages 返回 insufficient_quota。去控制台 充值。

SSE 流响应中断

客户端断了或上游限速。CLI 工具加 --no-stream 切换到非流式可绕过；或换网络环境。

① 准备：拿到 API 密钥

登录 fallbackp.top 进入控制台

充值 / 购买套餐

创建并复制 API 密钥