把 beara API 接入你常用的 AI 工具

1. 打开 beara 控制台并登录账号。
2. 进入 API 密钥 页面，点击创建新密钥。
3. 选择合适的分组。分组决定这把 Key 能使用哪些模型和额度。
4. 复制生成的 API Key，并在客户端里填写 API 根地址。

这是最省心的接入方式，适合 Codex、Cline、Continue、Cursor、VSCode 插件等本地开发工具。

1. 先安装并启动 CC-Switch。
2. 在 beara 控制台创建 API Key，并确认 Key 所属分组正确。
3. 在 API Key 列表里点击 导入到 CCS。
4. 完成后重启编辑器或相关插件，让新配置生效。

1. 打开 Cherry Studio 左下角设置。
2. 进入 提供商，添加自定义提供商。
3. 类型选择 OpenAI 或 OpenAI Compatible。
4. 按下面字段填写。

这类网页客户端一般都支持自定义 OpenAI 接口地址。

1. 进入客户端设置里的 OpenAI 或语言模型配置。
2. 打开自定义接口地址、代理地址或 Base URL 选项。
3. 填写 beara API 根地址和你的 API Key。

1. 打开浏览器扩展的设置。
2. 进入翻译服务，选择 OpenAI。
3. 展开更多设置，填写完整的 Chat Completions 地址。

OpenClaw 可通过 OpenAI 兼容 provider 接入 beara。

1. 确认已安装 OpenClaw，并完成初始化。
2. 打开 ~/.openclaw/openclaw.json。
3. 把 provider 的 baseUrl 和 apiKey 改为 beara。
4. 运行 openclaw gateway restart。

{
  "agents": {
    "models": {
      "providers": {
        "beara": {
          "api": "openai-completions",
          "baseUrl": "https://api.beara.top/v1",
          "apiKey": "sk-你的 beara API Key",
          "headers": {
            "User-Agent": "OpenClaw/JS"
          },
          "models": [
            { "id": "gpt-5.4", "contextWindow": 128000 }
          ]
        }
      }
    },
    "defaults": {
      "model": {
        "primary": "beara/gpt-5.4"
      }
    }
  }
}

如果你使用 CC-Switch，一键导入后通常不需要再手动编辑 Codex 配置。

1. 通过 beara 控制台的 导入到 CCS 写入配置。
2. 完全退出 Cursor 或 VSCode。
3. 重新打开编辑器和插件。
4. 如果仍未生效，检查插件设置里的 Base URL 是否为 beara 地址。

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的 beara API Key",
    base_url="https://api.beara.top/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "用一句话介绍 beara"}
    ],
)

print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "sk-你的 beara API Key",
  baseURL: "https://api.beara.top/v1",
});

const completion = await openai.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "Say hello to beara" }],
});

console.log(completion.choices[0].message.content);

可用模型由你的 API Key 分组决定。控制台能看到的模型才是最终可用模型。

请求 401 或无权限

通常是 API Key 填错、Key 被删除、复制时带了空格，或 Bearer 前缀重复。

请求 404

大多数客户端应该填写 https://api.beara.top/v1。少数客户端会自动补 /v1，此时可尝试填写 https://api.beara.top。

模型不可用

检查 API Key 所属分组是否包含该模型；如果分组没有绑定对应账号或账号异常，也会导致模型无法调度。

配置后不生效

完全退出客户端和编辑器后重新打开。很多插件会缓存旧配置，只刷新页面不一定生效。