文档 / 开始使用

快速开始

按下面四步完成第一次调用。已经有密钥的话,可以直接从第三步开始。

1. 注册账户

打开注册页,填写用户名和密码(8–128 位),注册后登录控制台。

目前不支持通过邮件找回密码,请妥善保存密码。登录后建议到「安全与访问」开启两步验证,见账户与 API 密钥。

2. 充值

到控制台「钱包」充值,¥1 = $1 额度:

  • 微信 / 支付宝:点钱包里的面额按钮购买卡密,再到激活页或钱包里兑换。
  • USDT / USDC:在钱包直接下单,链上确认后自动到账。

两种方式的步骤见充值。

3. 选分组,创建密钥

  1. 打开模型广场,找到要用的模型,记下它所在的分组和完整模型 ID。
  2. 打开「API 密钥」,点「创建 API 密钥」。
  3. 填一个好认的名称,在「分组」里选第 1 步记下的分组(必选),保存。
  4. 在密钥列表里点复制按钮,拿到完整密钥。

同一个模型可能出现在多个分组里,价格和稳定性不同。不知道选哪个,先看分组说明。

4. 接入客户端并发一条测试消息

客户端 教程
Codex(桌面版、CLI、IDE 扩展) Codex 接入教程
Claude Code Claude Code
Cherry Studio 等聊天客户端 客户端与接口地址
自己写程序 API 调用示例

最快的验证方式是 curl(把 sk-你的密钥 换成真实密钥,模型换成你分组里的模型):

curl https://api.peroai.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-astra", "messages": [{"role": "user", "content": "你好,请简短回复。"}]}'

收到回复后,到「使用日志」确认这次请求的模型、分组和扣费。测试请求同样会扣费。

遇到错误先保存完整的报错信息,再看故障排查,不要连续重复提交。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。