算力猫
← 返回教程列表

入门

三步上手:充值、建 Key、调用

第一次来?十分钟内跑通第一个请求。

约 10 分钟适合:第一次使用的开发者和普通用户

开始之前

  • 一个能收验证码的邮箱
  • 一种支付方式(具体开放哪些,以充值页显示为准)
  • 一个要接入的软件,或者一个终端窗口(macOS 的「终端」、Windows 的 PowerShell 都行)

步骤 1 · STEP 0x01

注册并登录

在官网点「开始使用」,填邮箱,点发送验证码,到邮箱里取 6 位验证码,设置密码,完成人机验证后注册。

注册
1

邮箱

you@mail.test
2
发送邮箱验证码
3

邮箱验证码

6 位数字
4

密码

至少 8 位,含字母和数字
5
注册
示意图,文字与实际页面一致,布局可能略有差别

注册后账户余额是 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 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 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)。