报错排查 · 500

500:先确认不是自己参数的问题

500 是服务端内部错误,但参数格式错误有时也会被包装成 500。先用最小请求复现,再看是不是只有某个模型/分组才出现。

三步定位

  1. 最小请求复现:去掉 tools、response_format、图片,只发一句 hello;
  2. 换模型:同分组换一个模型,换组再试;只有某个模型 500 说明是上游该模型的问题;
  3. 看响应体:带 request_id 或 trace 的信息要保留,联系客服时直接给。
最小复现bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

容易引发 500 的参数

  • response_format: json_schema:部分兼容模型不支持严格模式;
  • 多张图片 + 工具调用同时使用;
  • max_tokens 超过模型上限;
  • 空 messages 或最后一条是 assistant 消息。

什么时候该找客服

最小请求在多个分组都 500,且持续超过 10 分钟,属于上游故障。带上时间、模型名、request_id 与响应体联系 support@hardysapi.com。

常见问题

500 是我的问题还是平台的问题?

先去掉所有可选参数用最小请求测试;最小请求也 500 且换分组仍复现,基本是上游故障。

500 会扣费吗?

没有产生模型输出的失败请求不扣费。