Bob-Plugin-OpenAI-Translator 项目中的 Azure OpenAI 验证功能问题分析

在 Bob-Plugin-OpenAI-Translator 项目中，用户报告了一个关于 Azure OpenAI 验证功能失效的问题。本文将深入分析该问题的技术背景、原因及解决方案。

问题现象

用户在使用 Azure OpenAI 服务时发现，虽然配置完成后点击验证会出错，但保存后却能正常使用翻译功能。具体表现为验证时返回404错误，提示"Resource not found"。

技术分析

接口调用差异

经过排查发现，验证功能与正常翻译功能使用了不同的API端点：

1. 验证功能调用了/models端点
2. 实际翻译功能调用的是/chat/completions端点

这种不一致导致了验证失败但实际功能可用的现象。

API版本差异

进一步分析发现，验证功能使用了已过时的Completions API，而实际翻译功能使用的是较新的Chat Completions API。这是OpenAI API演进过程中的一个重要变化：

• Completions API：早期文本生成接口，现已标记为过时
• Chat Completions API：当前推荐的对话式交互接口

请求格式问题

验证请求的body格式为简单的prompt结构：

{"max_tokens":5,"prompt":"Once upon a time"}

而实际工作的翻译请求使用了完整的chat结构：

{
  "stream":true,
  "messages":[
    {"content":"You are a translation engine...","role":"system"},
    {"content":"translate from en to zh-Hans...","role":"user"}
  ],
  "frequency_penalty":1,
  "model":"gpt-3.5-turbo-16k",
  "temperature":0.2,
  "presence_penalty":1,
  "top_p":1,
  "max_tokens":1000
}

解决方案

开发团队通过以下步骤解决了该问题：

1. 统一验证和实际功能使用的API端点，均采用Chat Completions API
2. 调整验证请求的body格式，使其与实际翻译请求保持一致
3. 确保验证逻辑与实际使用逻辑完全一致

技术启示

1. API一致性：验证功能应与实际功能使用相同的接口和参数，才能准确反映真实使用情况
2. API演进：开发者需关注服务提供商的API更新，及时迁移到推荐的新接口
3. 错误处理：对于不同API版本返回的错误信息，应有明确的区分和处理逻辑

该问题的解决体现了开源社区快速响应和持续改进的特点，也为其他集成Azure OpenAI服务的开发者提供了有价值的参考。