Azure-Samples/azure-search-openai-demo项目中的计算机视觉API版本更新指南

在Azure-Samples/azure-search-openai-demo项目中，开发者遇到了计算机视觉API版本过时的问题。本文将详细介绍如何正确配置最新版本的计算机视觉API参数，帮助开发者顺利完成升级迁移。

问题背景

计算机视觉服务是Azure提供的重要AI能力之一，随着技术迭代，旧版API会逐步淘汰。近期2023-02-01-preview版本已被标记为弃用状态，开发者需要迁移到最新的GA版本。

参数配置要点

正确的API调用需要同时注意两个关键参数：

1. api-version：必须设置为"2024-02-01"，这是当前最新的稳定版本
2. model-version：应配置为"2023-04-15"，注意参数名中的连字符不能省略

错误示例：

params = {
    "api-version": "2024-02-01",
    "modelVersion": "2023-04-15"  # 错误的参数名格式
}

正确配置：

params = {
    "api-version": "2024-02-01",
    "model-version": "2023-04-15"  # 注意连字符
}

常见错误处理

开发者可能会遇到以下两类典型错误：

1. Gone错误：表明使用了已弃用的API版本

   {'error': {'code': 'Gone', 'message': 'Computer Vision 2023-02-01-preview has been deprecated...'}}
   

2. 404资源未找到：通常由参数名拼写错误导致，特别是model-version参数中的连字符容易被忽略

最佳实践建议

1. 定期检查Azure官方文档，了解API版本更新情况
2. 在代码中明确标注API版本信息，便于后续维护
3. 进行版本升级时，先在测试环境验证参数配置
4. 对于生产环境，建议实现版本兼容机制，确保平稳过渡

通过正确配置API参数，开发者可以充分利用Azure计算机视觉服务的最新功能，同时避免因版本过时导致的服务中断问题。