Google Vision API的languageHints参数失效：指定乌克兰语返回保加利亚语

问题重现 #

尝试通过Google Vision API识别乌克兰语文本，按照官方文档设置imageContext.languageHints为["uk"]或["uk-UA"]，但API始终返回保加利亚语（bg）的识别结果。

请求示例：

POST https://vision.googleapis.com/v1/images:annotate
{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "https://storage.googleapis.com/tmp_storage_pub/Screenshot_1.png"
        }
      },
      "features": [
        {
          "type": "DOCUMENT_TEXT_DETECTION"
        }
      ],
      "imageContext": {
        "languageHints": ["uk"]
      }
    }
  ]
}

响应片段：

"responses": [
    {
      "textAnnotations": [
        {
          "locale": "bg",
          "description": "EPAШОВА",
          "boundingPoly": {
            "vertices": []
          }
        }
      ],
      "fullTextAnnotation": {
        "pages": [
          {
            "property": {
              "detectedLanguages": [
                {
                  "languageCode": "bg",
                  "confidence": 1
                }
              ]
            }
          }
        ]
      }
    }
]

可能的解决方向 #

• 明确语言提示的优先级逻辑：languageHints是API的参考提示而非强制规则，当文本的字符组合、词汇模式更匹配保加利亚语时，API会优先返回自动检测结果。可以尝试在提示中同时添加保加利亚语并调整顺序（如["uk", "bg"]），引导API优先考虑乌克兰语。
• 禁用自动语言检测：在imageContext中添加textDetectionParams并设置enableLanguageDetection为false，强制API使用指定的语言提示进行识别：

  "imageContext": {
    "languageHints": ["uk"],
    "textDetectionParams": {
      "enableLanguageDetection": false
    }
  }
  

• 检查文本特征与图像质量：乌克兰语和保加利亚语共享西里尔字母体系，部分字符视觉高度相似。确认待识别文本是否存在易混淆的字符，同时检查图像清晰度、是否有噪点或字符模糊，这些都会影响API的语言判定。
• 切换检测模式：当前使用的DOCUMENT_TEXT_DETECTION侧重文档整体语言特征，若识别对象是短文本或单行内容，可尝试改用TEXT_DETECTION，观察识别结果是否变化。

内容的提问来源于stack exchange，提问作者Ivan Drobot