通过

快速入门：使用计算机视觉 REST API 和 cURL 分析本地图像

  • 项目

在本快速入门中，你将使用计算机视觉的 REST API 分析本地存储的图像以提取视觉特征。 使用分析图像方法，可以根据图像内容提取视觉特征。

如果没有 Azure 订阅，可在开始前创建一个试用帐户。

先决条件

  • 必须具有 cURL。
  • 必须具有计算机视觉的订阅密钥。 你可以按照创建认知服务帐户中的说明订阅计算机视觉并获取密钥。

创建并运行示例命令

要创建和运行示例，请执行以下步骤：

  1. 将以下命令复制到文本编辑器中。
  2. 必要时在命令中进行如下更改：
    1. 将 <subscriptionKey> 的值替换为你的订阅密钥。
    2. 如有必要，请将请求 URL (https://api.cognitive.azure.cn/vision/v2.0/analyze) 替换为获取的订阅密钥所在的 Azure 区域中的分析图像方法的终结点 URL。
    3. 将 <localImage> 的值替换为要分析的图像的完整路径和文件名。 例如 @C:/Pictures/ImageToAnalyze.jpg。
    4. （可选）更改请求 URL (language=en) 的语言参数以使用其他支持的语言。
  3. 打开命令提示符窗口。
  4. 将文本编辑器中的命令粘贴到命令提示符窗口，然后运行命令。
curl -H "Ocp-Apim-Subscription-Key: <Subscription Key>" -H "Content-Type: application/octet-stream" "https://api.cognitive.azure.cn/vision/v2.0/analyze?visualFeatures=Categories,Description&details=Landmarks&language=en" --data-binary "<localImage>"

检查响应

成功的响应以 JSON 格式返回。 示例应用程序会在命令提示符窗口中分析和显示成功响应，如下例所示：

{
  "categories": [
    {
      "name": "outdoor_water",
      "score": 0.9921875,
      "detail": {
        "landmarks": []
      }
    }
  ],
  "description": {
    "tags": [
      "nature",
      "water",
      "waterfall",
      "outdoor",
      "rock",
      "mountain",
      "rocky",
      "grass",
      "hill",
      "covered",
      "hillside",
      "standing",
      "side",
      "group",
      "walking",
      "white",
      "man",
      "large",
      "snow",
      "grazing",
      "forest",
      "slope",
      "herd",
      "river",
      "giraffe",
      "field"
    ],
    "captions": [
      {
        "text": "a large waterfall over a rocky cliff",
        "confidence": 0.916458423253597
      }
    ]
  },
  "requestId": "b6e33879-abb2-43a0-a96e-02cb5ae0b795",
  "metadata": {
    "height": 959,
    "width": 1280,
    "format": "Jpeg"
  }
}

后续步骤

了解计算机视觉 API，它用于分析图像、检测名人和地标、创建缩略图，并提取印刷体文本和手写文本。 要快速体验计算机视觉 API，请尝试使用 Open API 测试控制台。

探索计算机视觉 API