快速开始
按下面四步完成第一次调用。已经有密钥的话,可以直接从第三步开始。
1. 注册账户
打开注册页,填写用户名和密码(8–128 位),注册后登录控制台。
目前不支持通过邮件找回密码,请妥善保存密码。登录后建议到「安全与访问」开启两步验证,见账户与 API 密钥。
2. 充值
到控制台「钱包」充值,¥1 = $1 额度:
- 微信 / 支付宝:点钱包里的面额按钮购买卡密,再到激活页或钱包里兑换。
- USDT / USDC:在钱包直接下单,链上确认后自动到账。
两种方式的步骤见充值。
3. 选分组,创建密钥
- 打开模型广场,找到要用的模型,记下它所在的分组和完整模型 ID。
- 打开「API 密钥」,点「创建 API 密钥」。
- 填一个好认的名称,在「分组」里选第 1 步记下的分组(必选),保存。
- 在密钥列表里点复制按钮,拿到完整密钥。
同一个模型可能出现在多个分组里,价格和稳定性不同。不知道选哪个,先看分组说明。
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": "你好,请简短回复。"}]}'
收到回复后,到「使用日志」确认这次请求的模型、分组和扣费。测试请求同样会扣费。
遇到错误先保存完整的报错信息,再看故障排查,不要连续重复提交。