Use API Key

Brioi API 密钥使用说明

文档内容按 sub2api 前端的“使用 API 密钥”弹窗真实模板整理。

这页只负责接入，不讲购买流程。请优先以 Brioi 后台弹窗里显示的内容为准。本文为了和你当前项目实例保持一致，示例统一使用截图里出现的 https://brioi.com，并保留上游源码里对 OpenCode 自动补 /v1 的行为。

Quick Start

快速开始

如果你只想尽快接入，按下面三步做即可。先创建一把新 Key，再打开后台“使用 API 密钥”弹窗，最后把对应客户端模板直接填到本地配置里。

  1. 创建密钥

    控制台进入 API Keys 页面。创建后的完整密钥通常只展示一次，建议按客户端分别创建，便于后续轮换。

  2. 选择对应模板

    弹窗内置 Codex CLI、Codex CLI (WebSocket)、Claude Code、OpenCode。OpenClaw 不在弹窗内，本页单独补充。

  3. 原样填入配置

    Codex 与 Claude Code 模板直接使用弹窗里给出的根 Base URL。OpenCode 模板会在根地址基础上补成 /v1。保存后重开终端或客户端再验证。

Codex CLI

Codex CLI 配置说明

这部分直接对应上游弹窗的 `Codex CLI` 标签。请确保以下内容位于 config.toml 文件的开头部分，且目录存在。

npm install -g @openai/codex
# ~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://brioi.com"
wire_api = "responses"
requires_openai_auth = true
# ~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-在此处替换成你的 API 密钥"
}

macOS / Linux 目录是 ~/.codex；Windows 目录是 %userprofile%\.codex。改完后直接运行 codex 验证配置。

Codex CLI WebSocket

Codex CLI（WebSocket）配置说明

这部分对应上游弹窗的 `Codex CLI (WebSocket)` 标签。相比普通 Codex 模板，只额外多两处 WebSocket 开关。

# ~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://brioi.com"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true

[features]
responses_websockets_v2 = true
# ~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-在此处替换成你的 API 密钥"
}

只有在你明确需要 WebSocket 模式时才用这套配置；普通场景优先使用上一节的标准 Codex CLI 模板。

OpenClaw

OpenClaw 配置说明

补充章节：当前上游弹窗未内置 OpenClaw 专用模板。这一节基于你指定的 OpenClaw 参考文档整理，并按 Brioi 当前接入地址适配。

OpenClaw 对运行环境和配置格式更敏感，推荐先确认 Node.js 22 或更高版本，再准备 ~/.openclaw/openclaw.json。

# 安装与检查
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
openclaw doctor
# ~/.openclaw/openclaw.json
{
  "models": {
    "mode": "merge",
    "providers": {
      "brioi": {
        "baseUrl": "https://brioi.com/v1",
        "apiKey": "sk-在此处替换成你的 API 密钥",
        "auth": "api-key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "api": "openai-responses",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "brioi/gpt-5.4"
      }
    }
  }
}
# 可选：如果你不想用默认路径
export OPENCLAW_CONFIG_PATH="$HOME/.openclaw/openclaw.json"
openclaw doctor

OpenClaw 这套配置里最容易出错的是四个字段：baseUrl、apiKey、auth、api。其中 auth 必须是 api-key，api 必须是 openai-responses。

OpenCode

OpenCode 配置说明

这部分对应上游弹窗的 `OpenCode` 标签。源码里会自动把根地址补成 /v1，所以这里和 Codex / Claude Code 不同。

# 配置文件路径
~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://brioi.com/v1",
        "apiKey": "sk-在此处替换成你的 API 密钥"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        }
      }
    }
  },
  "agent": {
    "build": {
      "options": {
        "store": false
      }
    },
    "plan": {
      "options": {
        "store": false
      }
    }
  }
}

上游弹窗生成的是更完整的模型列表，这里只保留最关键字段。若你在后台能直接看到完整 opencode.json，优先复制后台原文。

Claude Code

Claude Code 配置说明

这部分对应上游弹窗的 `Claude Code` 标签。源码会同时给出当前终端环境变量和 ~/.claude/settings.json 配置文件两套写法。

npm install -g @anthropic-ai/claude-code
# macOS / Linux 当前终端临时生效
export ANTHROPIC_BASE_URL="https://brioi.com"
export ANTHROPIC_AUTH_TOKEN="sk-在此处替换成你的 API 密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# PowerShell
$env:ANTHROPIC_BASE_URL="https://brioi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-在此处替换成你的 API 密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-在此处替换成你的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://brioi.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

如果你的密钥弹窗里没有 `Claude Code` 标签，通常不是文档问题，而是当前分组没有开启对应能力。保存配置后重新打开终端，再运行 claude 验证。

Troubleshooting

常见问题

API 密钥丢了怎么办？

通常无法再次查看完整旧密钥，直接在控制台新建一把即可。创建后记得同步替换所有客户端里的旧 Key。

为什么 Codex 和 Claude Code 用的是根域名，OpenCode 却是 /v1？

这是上游 UseKeyModal.vue 的真实逻辑：Codex / Claude Code 直接吃传入的 baseUrl，OpenCode 会先把根地址标准化成 /v1。

Codex 配置后还是不生效？

优先检查 config.toml 是否放在 ~/.codex 或 %userprofile%\.codex 下，并确保关键内容位于文件开头。

为什么我的弹窗里没有 Claude Code 标签？

上游前端只有在当前分组允许对应能力时才会显示该标签。如果没有看到，说明不是文档写漏了，而是当前密钥分组本身不支持。

什么时候该用 Codex CLI（WebSocket）？

只有你明确需要 WebSocket 模式时才切到这一项。普通情况直接用标准 Codex CLI 模板，少两个开关，兼容性也更高。

OpenCode 配置不生效怎么办？

先确认全局配置路径是 ~/.config/opencode/opencode.json，再检查是否存在项目级 opencode.json 覆盖了全局配置。

为什么这里不再单列 OpenClaw？

因为当前上游“使用 API 密钥”弹窗并没有提供 OpenClaw 专用模板。这版文档优先对齐真实源码和后台弹窗，避免继续写成和实际产品不一致的样子。