算力猫
← 返回教程列表

接入软件

curl 与流式输出

用命令行直接测试接口:对话、流式、模型列表。

约 6 分钟适合:想先确认接口通不通、或排查问题的用户

开始之前

  • 一个终端
  • 一把 Key,先放进环境变量

步骤 1 · STEP 0x01

设置变量

terminal
$ export API_KEY=<你的 Key>$ export BASE=https://api.suanlimao.shop/v1
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 Key →

步骤 2 · STEP 0x02

看有哪些模型

terminal
$ curl -s $BASE/models -H "Authorization: Bearer $API_KEY"{"object":"list","data":[{"id":"…"}, …]}
返回的是 OpenAI 格式的模型列表。以模型广场为准:那里标明了每个模型是否已开卖、支持哪些接口。

打开模型广场 →

步骤 3 · STEP 0x03

普通对话

terminal
$ curl -s $BASE/chat/completions \    -H "Authorization: Bearer $API_KEY" \    -H "Content-Type: application/json" \    -d '{"model":"<模型名>","messages":[{"role":"user","content":"Hello"}]}'{"choices":[{"message":{"content":"Hello! …"}}],"usage":{…}}
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

步骤 4 · STEP 0x04

流式输出

terminal
$ curl -sN $BASE/chat/completions \    -H "Authorization: Bearer $API_KEY" \    -H "Content-Type: application/json" \    -d '{"model":"<模型名>","stream":true,"messages":[{"role":"user","content":"Count to 3"}]}'data: {"choices":[{"delta":{"content":"1"}}]}data: {"choices":[{"delta":{"content":", 2"}}]}data: [DONE]
  • -N 关闭 curl 的缓冲,才能看到逐块输出。
  • 看到 : ping 开头的行是保持连接的心跳,不是错误。
  • 中途按 Ctrl-C 断开,按已经生成的 token 计费。

步骤 5 · STEP 0x05

看清失败的原因

terminal
$ curl -i $BASE/chat/completions -H "Authorization: Bearer wrong" \    -H "Content-Type: application/json" -d '{}'HTTP/2 401{"error":{"message":"…","type":"…","code":"invalid_api_key"}}

加 -i 能看到 HTTP 状态码和响应头(包括 x-ratelimit-*、Retry-After)。错误码对照见「错误码速查」。

✓ 怎么确认成功了

  • 普通对话返回含 choices 的 JSON,流式能逐块出现并以 [DONE] 结束。

常见问题

Windows 的 PowerShell 怎么写?

把 export 换成 $env:API_KEY = "…",命令里的 $API_KEY 换成 $env:API_KEY,续行符 \ 换成反引号。也可以直接用 Windows 自带的终端里的 WSL。

请求发出去很久没反应?

长回答可能耗时几十秒,用流式输出更直观;仍然卡住,见「连不上、流式中断、选哪个域名」。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。