开发接入 · cURL

cURL 速查:八条命令覆盖九成场景

排查问题最快的办法是用 cURL 脱离客户端直连。下面八条覆盖了日常绝大部分场景。

1. 最小对话

chatbash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

2. 列可用模型

modelsbash
curl https://hardysapi.com/v1/models -H "Authorization: Bearer $KEY" | python3 -m json.tool | grep '"id"'

3. 流式

streambash
curl -N https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"数到十"}]}'

4. 看耗时与状态

timingbash
curl -o /dev/null -s -w "code=%{http_code} ttfb=%{time_starttransfer} total=%{time_total}\n" \
  https://hardysapi.com/v1/models -H "Authorization: Bearer $KEY"

5. 看完整响应头

headersbash
curl -s -D - -o /dev/null https://hardysapi.com/v1/models \
  -H "Authorization: Bearer $KEY"

6. 只打印错误体

errbash
curl -s https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"不存在的模型","messages":[]}' | python3 -m json.tool

7. 带图片

visionbash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":[
      {"type":"text","text":"图里是什么"},
      {"type":"image_url","image_url":{"url":"https://example.com/a.jpg"}}]}]}'

8. 工具调用

toolsbash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"北京天气"}],
       "tools":[{"type":"function","function":{"name":"get_weather",
       "parameters":{"type":"object","properties":{"city":{"type":"string"}}}}}]}'
Windows 的 PowerShell 里 curl 是 Invoke-WebRequest 的别名,要写 curl.exe, 或把 JSON 存成文件用 -d "@body.json"。

常见问题

Windows 上 curl 的 JSON 引号怎么处理?

用 curl.exe 并把 JSON 写入文件,再 -d "@body.json",可以避免引号转义问题。

流式用 curl 看效果要加什么参数?

加 -N(禁用缓冲),并设置 stream:true,就能看到分块输出。