Form Recognizer标注工具API版本是否与Docker镜像版本绑定？

1. 标注工具API版本与Docker镜像的绑定关系 #

标注工具使用的API版本确实由运行的Docker镜像版本固定，你提到的两个镜像对应的API端点完全正确：

• 使用mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1（2.1 GA正式版镜像）时，对应调用的v2.1正式版API，端点前缀为https://{endpoint}/formrecognizer/v2.1/custom/models/...
• 使用mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-preview（预览版镜像）时，对应调用的v2.1-preview.3预览版API，端点前缀为https://{endpoint}/formrecognizer/v2.1-preview.3/custom/models/...

2. 自定义API版本的可行性 #

目前标注工具没有提供可显式设置API版本的配置项，API版本为镜像打包时内置的固定值，无法手动修改。
如果需要确认当前工具使用的API版本，可直接查看所用Docker镜像的版本标签，或者在工具发起训练请求时查看请求URL路径中的版本段，即可得到准确值。

3. .fott文件version属性的含义 #

该属性为标注工具的项目文件规则版本标识，作用是匹配对应版本标注工具的解析逻辑，避免版本不兼容导致项目配置、标注数据读取异常：

• 2.1-preview.3预览版工具创建的项目该值为2.1.0，对应预览版的项目解析规则
• 2.1 GA正式版工具创建的项目该值为2.1，对应正式版的项目解析规则
  两个版本的项目文件互相兼容，正式版工具可正常打开预览版创建的.fott项目，不会丢失历史标注数据。

内容的提问来源于stack exchange，提问作者Karthik R