Claude API Error 400：请求格式错误怎么解决

30 秒结论

400 是你的请求体不符合接口规范，服务端拒绝解析。 Anthropic 的 400 有一个高频坑：忘了传 max_tokens（它是必填项，OpenAI 那边是可选）。

报错原文对照

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens: Field required"}}

{"type":"error","error":{"type":"invalid_request_error","message":"messages: Input should be a valid list"}}

{"type":"error","error":{"type":"invalid_request_error","message":"temperature: Input should be a valid number, unable to parse string as a number"}}

原因排序

修法

最小可复现请求

先用这个跑通，再一点点加参数：

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

跑通了再逐个加：system → temperature → tools → stream。

messages 的正确结构

[
  {"role": "user", "content": "第一条"},
  {"role": "assistant", "content": "回复"},
  {"role": "user", "content": "第二条"}
]

常见错误：

• content 写成对象而不是数组/字符串
• role 写成 human / ai
• 第一条就是 assistant

责任判定表

推理模型的坑

o1 / o3 / deepseek-reasoner 这类推理模型不接受 temperature。传了就是 400，报错里会说 unsupported parameter。