快速开始

本页带你从零跑通彼源 AI：注册 → 创建令牌 → 选模型 → 发送第一次请求。全程约 5 分钟。

只想在网页上聊天、不写代码？跳到操练场或一键打开聊天应用。

第一步：注册并登录

1. 打开 https://biyuan.ai。
2. 点右上角「登录 / 注册」，注册并登录后进入控制台。

第二步：创建令牌

令牌（Token）就是调用 API 用的密钥，以 sk- 开头。

:::info 先看一眼余额 令牌能分配的额度来自账户余额。新注册账户是否附带试用额度，以控制台「钱包管理」显示的余额为准；余额为 0 就先充值，否则后面发请求会遇到 403。 :::

1. 在控制台左侧打开 令牌管理。
2. 点 添加令牌，填写：
   • 名称：写清用途，方便日后分辨，例如 first-test、cursor。
   • 令牌分组：选 default（默认计划）即可。
   • 金额：够测试就行；或直接打开「无限额度」（仍受账户剩余额度约束）。
3. 保存后，点新令牌的复制按钮，得到形如 sk-xxxxxxxx 的密钥。

:::warning 保管好你的令牌 令牌等同于密码。不要贴进截图、聊天记录、公开仓库或工单。怀疑泄露就回到「令牌管理」停用或重建。 :::

第三步：选一个模型

打开模型广场，挑一个模型，点 复制模型 ID。

模型和价格会更新，始终以模型广场为准。

第四步：发送第一次请求

方式一：操练场（推荐，无代码）

不想用命令行？到操练场选同一个模型发一句话，能收到回复就算跑通——账号和额度都正常。注意：操练场用的是网页登录身份，验证不了你第二步创建的令牌；令牌要靠方式二（或任一客户端）实际调用一次来验证。

方式二：终端 curl（可选）

终端是电脑自带的命令输入窗口（macOS 打开「终端/Terminal」，Windows 打开 PowerShell）；curl 是系统自带的发请求工具，粘贴整段命令回车即可。

把下面命令里的 <YOUR_TOKEN> 换成第二步复制的令牌；示例里的 gpt-5.4 换成你在第三步复制的模型 ID：

curl https://api.biyuan.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己。"}
    ]
  }'

看到什么算成功：返回一大段文字，能在里面找到 choices 和模型的回答。你的第一次调用就成功了。

想接着接入 Cursor、Claude Code 等工具？带上同一个令牌即可，见接入开发工具。

遇到问题

你看到	原因	怎么办
401 / 无效的令牌	令牌没带上、复制不全或已停用	确认请求头（随请求一起发送的身份信息）是 Authorization: Bearer sk-...（Bearer 后面跟你的令牌），重新完整复制令牌
该令牌无权访问模型	令牌限制了可用模型，或模型名写错	换一个模型 ID，或到「令牌管理」编辑该令牌放开模型（需开启高级模式）
该令牌额度已用尽（403）	这个令牌自身的限额用完了，给账户充值不能解除	到「令牌管理」编辑该令牌调高额度（需开启高级模式），或新建一个足额令牌更换；「用户额度不足」才是账户余额不够，去「钱包管理」充值
404 / Invalid URL	地址漏了 /v1	SDK 和标准 OpenAI 客户端用 https://api.biyuan.ai/v1；会自行拼接 /v1 的客户端（如 Cherry Studio、NextChat、Claude Code）按各自接入页填不带 /v1 的地址
429	触发频率限制	先等几秒再重试；还不行就把每次的等待时间翻倍（这个做法叫「指数退避」）

更多错误见错误与状态码。

继续阅读

• API 快速开始：把它接进代码
• 令牌管理：按用途拆分令牌
• 接入 Cursor