OneModel

主题

快速开始 ​

准备一个 OneModel 账户、一枚 API Key，以及你想使用的客户端。按下面三步完成接入。

1. 注册并兑换 ​

  1. 打开 OneModel 官网 并注册账号。
  2. 如果还没有兑换码，可前往原教程提供的 卡密购买页面。
  3. 登录后进入 个人资料 → 兑换码，输入兑换码并点击「立即兑换」。
  4. 确认账户余额已经到账。

如果拿到的是 https://one-model.com/redeem?code=xxx 形式的兑换链接，登录后打开，兑换码会自动填入。

2. 创建 API Key ​

  1. 打开控制台的 API Keys 页面。
  2. 点击「创建 API Key」，为密钥填写一个便于识别的名称，例如 我的 Claude Code。
  3. 如果页面提供分组选项，选择与你要调用的模型对应的分组。
  4. 创建后复制 Key，并妥善保存。

密钥只填写在你信任的客户端中

教程中的 sk-your-api-key 是占位符，需要替换成你自己的 Key。不要把真实密钥放入代码仓库、截图或公开聊天记录。

3. 连接你的客户端 ​

你正在使用接入方式
Claude CodeCC Switch 导入或手动配置
Codex CLICC Switch 导入或配置自定义供应商
Roo Code / Kilo CodeRoo Code · Kilo Code
WorkBuddy / TraeWorkBuddy · Trae
Cherry Studio / ChatBoxCherry Studio · ChatBox
自己的程序或脚本API 调用示例

不知道地址该怎么填？先看 接入地址与参数，区分 Base URL 和完整请求地址。

确认接入成功 ​

配置保存后，重新打开客户端，选择你配置的模型，发送一句「你好」。

  • 收到正常回复：说明这次调用成功。
  • 控制台产生用量记录：在 用量页面 核对调用模型、Token 数和扣费。
  • 出现错误：按 常见问题 检查地址、Key、模型和线路。

已有 API Key？

可以直接从客户端指南开始，不必重复创建密钥。