消息角色错误：role 不合法

30 秒结论

role 只能是 system / user / assistant（部分支持 tool）。

报错原文对照

{"error":{"message":"Invalid role: human"}}

原因排序

概率	原因
55%	用了 human/ai 这类别名
30%	首条是 assistant
15%	role 拼错

修法

先在自己这边查

1. 统一用 user/assistant
2. 首条必须是 user 或 system
3. 检查是否混用了不同厂商的格式

再往服务方查

这一项不是你这边能解决的。

责任判定表

现象	责任方
所有模型都报	格式
只有某厂商报	方言差异
偶发	拼接逻辑

什么时候该换

跨厂商迁移时最容易犯这个错。