消息角色错误：role 不合法

30 秒结论

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

报错原文对照

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

原因排序

修法

先在自己这边查

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

再往服务方查

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

责任判定表

什么时候该换

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