","message":"developer is not one of ['system', 'assistant', 'user', 'tool', 'fu...

2026年10月11日 11:39 9.39 秒 success

错误信息

400: {"code":"invalid_parameter_error","message":"developer is not one of ['system', 'assistant', 'user', 'tool', 'function']","param":null,"type":"invalid_request_error"}

AI 解决方案

## 🌐 错误翻译


原文:400: {"code":"invalid_parameter_error","message":"developer is not one of ['system', 'assistant', 'user', 'tool', 'function']","param":null,"type":"invalid_request_error"}
译文:400: {"code":"invalid_parameter_error","message":"developer角色不是['system','assistant','user','tool','function']中的任何一种","param":null,"type":"invalid_request_error"}

## 🎯 原因分析


错误原因是请求参数中的"developer"角色不符合API规定的允许值,有效角色仅包含system、assistant、user、tool、function,"developer"不在许可范围内。

## 💡 解决方案


将请求中的"developer"角色更改为上述合法角色之一,具体取决于你的使用场景,常用场景应使用user(用户角色)或system(系统角色)。

// 错误角色修复示例(原来为developer,修改为合法角色user)
const messages = [
  { role: "system", content: "系统提示词" },
  { role: "user", content: "用户输入内容" },  // 正确替换developer角色
  { role: "assistant", content: "AI回复内容" }
];

## 🛡️ 预防措施


  • 调用API前查阅官方文档,确认所有参数的合法取值范围,避免使用未定义或已废弃的参数值。

  • 使用API请求验证工具(如Postman)或开发框架内置的参数校验功能,提交请求前检查参数合法性。