cURL 与 HTTP

当 SDK 或第三方客户端表现异常时，直接用 cURL 请求可以快速判断问题出在密钥、网络还是客户端配置。

查询可用模型

curl https://api.lowprice.one/v1/models \
  -H "Authorization: Bearer $LOWPRICE_API_KEY"

如果返回 401，说明鉴权没有通过；如果返回模型列表，说明 Base URL、网络和密钥链路基本正常。

创建对话补全

curl https://api.lowprice.one/v1/chat/completions \
  -H "Authorization: Bearer $LOWPRICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你的模型调用名",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

查看完整响应头

排查 429 或代理层问题时，可以加上 -i：

curl -i https://api.lowprice.one/v1/models \
  -H "Authorization: Bearer $LOWPRICE_API_KEY"

重点记录：

• HTTP 状态码
• X-Request-Id 或 X-Client-Request-Id
• Retry-After，如果存在
• Response Body 中的错误代码与消息

流式响应

curl -N https://api.lowprice.one/v1/chat/completions \
  -H "Authorization: Bearer $LOWPRICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你的模型调用名",
    "stream": true,
    "messages": [
      {"role": "user", "content": "分段输出一段介绍"}
    ]
  }'

-N 可以关闭 cURL 输出缓冲，便于观察流式数据。服务端事件通常以 data: 开头，并最终发送一个结束事件。

最小排查顺序

1. 用 GET /v1/models 验证鉴权
2. 用一次非流式 POST /v1/chat/completions 验证模型与请求体
3. 再开启 stream: true
4. 最后回到原 SDK 或客户端

加密钥后的代理排查

如果本机需要代理，先确认代理本身可以访问 api.lowprice.one。不要在终端历史、脚本或截图中留下真实 API Key。