入门
三步上手:充值、建 Key、调用
第一次来?十分钟内跑通第一个请求。
约 10 分钟适合:第一次使用的开发者和普通用户
开始之前
- 一个能收验证码的邮箱
- 一种支付方式(具体开放哪些,以充值页显示为准)
- 一个要接入的软件,或者一个终端窗口(macOS 的「终端」、Windows 的 PowerShell 都行)
步骤 1 · STEP 0x01
注册并登录
在官网点「开始使用」,填邮箱,点发送验证码,到邮箱里取 6 位验证码,设置密码,完成人机验证后注册。
注册
注册后账户余额是 0,不赠送试用额度,所以下一步要先充值。
步骤 2 · STEP 0x02
充值
进入控制台的「余额与充值」,选金额和支付方式,点「去支付」,按页面提示完成支付。到账后余额会立刻显示。
余额与充值
1
充值金额(USD)
按页面给出的档位或自己输入
2
支付方式
USDT(TRC20)/ 支付宝 / 微信(以页面为准)
3
去支付
步骤 3 · STEP 0x03
创建 API Key
进入「API Key」页面,给 Key 起个名字,点「创建 Key」。
API Key
1
名称
例如:我的笔记本
2
预算(USD,留空不限)
5 小时 / 1 天 / 7 天 / 每月 / 累计
3
创建 Key
API Key
请立即复制保存,这是唯一一次显示完整 Key。
<完整 Key 只在这里出现一次>
1
复制
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。
步骤 4 · STEP 0x04
发出第一个请求
把下面的命令复制到终端,把 <你的 Key> 换成你的 Key,把 <模型名> 换成从模型广场复制的模型名。
terminal
$ curl https://api.suanlimao.shop/v1/chat/completions \ -H "Authorization: Bearer <你的 Key>" \ -H "Content-Type: application/json" \ -d '{"model":"<模型名>","messages":[{"role":"user","content":"Hello"}]}'{"choices":[{"message":{"role":"assistant","content":"Hello! …"}}], …}
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
接入地址写
https://api.suanlimao.shop/v1(带 /v1)。如果软件提示 404,先检查有没有多写或少写 /v1,再看下面的常见问题。✓ 怎么确认成功了
- 终端里返回一段 JSON,
choices里有模型的回答。 - 控制台「用量」页出现这次请求,「余额与充值」页的余额略有减少。
常见问题
返回 402 或 insufficient_quota 是怎么回事?
余额不足。新账户余额是 0,需要先充值;已有余额但很低时,也要保留页面提示的最低余额。
返回 401 或 invalid_api_key?
Key 复制不完整、多了空格,或者已经被吊销。回到「API Key」页确认状态,必要时新建一把。
返回 404 model_not_found?
模型名写错,或者该模型还没开卖。从模型广场复制模型名,看卡片上是否显示「已开卖」。
我在中国大陆,用哪个地址?
中文界面默认给加速地址,更稳;如果它连不上,换成教程里标注的备选域名。详见「连不上、流式中断、选哪个域名」。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。