如何为Azure OpenAI选择合适的openai.api_version？

核心影响因素 #

• 功能需求与模型特性
  不同API版本对应不同的功能支持度：2023-05-15是正式稳定版，覆盖Chat Completions等成熟功能；2023-03-15-preview属于预览版，可能包含一些未正式发布的实验性功能（比如早期适配tiktoken的相关优化）。如果你的代码依赖某类仅预览版支持的功能（比如特定微调参数、新模型调用方式），就选对应预览版；追求稳定生产环境的话，优先正式版。
• Azure实例与模型部署的兼容性
  部分新API版本会先在特定Azure区域上线，要是你的实例所在区域还没支持该版本，只能用已兼容的旧版本。另外，某些较新的模型变体（比如特定的GPT-4部署）可能仅适配较新的API版本，旧版本无法正常调用。
• 官方文档的对应版本
  你用到的功能对应的官方文档会明确标注推荐的API版本，比如调用Chat Completions的正式文档会指定2023-05-15，涉及预览功能的文档则会给出对应的预览版号，跟着文档选准没错。

确认可用API版本的方法 #

• 登录Azure门户，进入你的Azure OpenAI资源，在概述或API密钥和终结点页面，能看到官方列出的兼容API版本；
• 用Azure CLI执行命令：az cognitiveservices account show --name <你的资源名> --resource-group <你的资源组>，返回结果里的apiVersions字段就是支持的版本列表；
• 调用元数据接口：发送GET https://<你的资源域名>.openai.azure.com/openai/deployments/<你的部署名>?api-version=2023-05-15请求，响应中会包含该模型部署兼容的API版本范围。

内容的提问来源于stack exchange，提问作者Franck Dernoncourt