Promptfoo项目中o4-mini模型API调用问题解析

在Promptfoo项目使用过程中，开发者发现o4-mini模型在YAML配置中存在一个关键的技术限制：该模型仅支持responses API而不兼容chat completions API。这个问题在0.110.0版本中表现尤为明显。

当开发者尝试通过openai:o4-mini或openai:chat:o4-mini配置调用模型时，系统会抛出API异常，提示"max_tokens参数不被支持，请改用max_completion_tokens"。这个错误源于底层API的参数传递机制差异。

技术分析表明，o4-mini模型在设计上采用了与传统模型不同的参数规范。其核心区别在于：

1. 明确要求使用max_completion_tokens而非max_tokens参数
2. 对JSON格式响应有特殊支持要求
3. 需要单独设置reasoning_effort推理强度参数

该问题已在Promptfoo 0.110.1版本中得到修复。更新后的版本正确处理了参数映射关系，确保max_tokens参数不会错误传递，同时完整保留了max_completion_tokens的功能支持。对于开发者而言，这意味着现在可以：

• 安全地在YAML配置中使用o4-mini模型
• 充分利用其特有的长文本处理能力（支持高达60000 tokens）
• 保持JSON格式输出的稳定性

这个案例很好地展示了AI基础设施层如何处理不同模型API的兼容性问题，也提醒开发者在集成新模型时需要注意参数规范的差异性。Promptfoo团队通过快速响应和版本更新，展现了良好的开源项目维护能力。

对于技术团队的建议：

1. 及时更新到最新版本以获得完整功能支持
2. 仔细阅读各模型特有的API文档
3. 在配置复杂模型时，先进行小规模测试验证