接入软件
curl 与流式输出
用命令行直接测试接口:对话、流式、模型列表。
约 6 分钟适合:想先确认接口通不通、或排查问题的用户
开始之前
- 一个终端
- 一把 Key,先放进环境变量
步骤 1 · STEP 0x01
设置变量
terminal
$ export API_KEY=<你的 Key>$ export BASE=https://api.suanlimao.shop/v1
完整 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)。