使用 Cloud Vision API 检测图片中的标签

本快速入门将引导您逐步完成以下过程:

  • 创建 Cloud Storage 存储桶。
  • 将图片上传到 Cloud Storage 并将其公开。
  • 向 Vision API 发出处理该图片的请求。

完成上述步骤需要大约 5 分钟。您每月可以免费在 Cloud Storage 中存储多达 5GB 的数据,并可以免费向 Vision API 发出多达 1000 个功能请求

开始之前

如果您尚未设置项目并创建 Google Cloud Storage 存储桶,请首先按照下文所述进行操作。

设置项目

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  3. 确保您的 Google Cloud 项目已启用结算功能

  4. 启用 Cloud Vision API。

    启用 API

  5. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  6. 确保您的 Google Cloud 项目已启用结算功能

  7. 启用 Cloud Vision API。

    启用 API

创建 Cloud Storage 存储桶

  1. 在 Google Cloud 控制台中,进入 Cloud Storage 存储桶页面。

    进入“存储桶”页面

  2. 点击创建存储桶
  3. 创建存储桶页面上,输入您的存储桶信息。要转到下一步,请点击继续
    • 指定存储桶的名称中,输入唯一的存储桶名称。请勿在存储桶名称中添加敏感信息,因为存储桶命名空间是全局性的,公开可见。
    • 对于选择数据存储位置,执行以下操作:
      • 选择位置类型选项。
      • 选择位置选项。
    • 对于为数据选择一个默认存储类别,选择以下项: Standard
    • 对于选择如何控制对象的访问权限,请选择访问权限控制选项。
    • 对于高级设置(可选),请指定加密方法保留政策存储桶标签
  4. 点击创建

向 Cloud Vision API 服务发出请求

  1. 下载 demo-img.jpg。 (您可能需要右键点击该链接。)

  2. 打开“Cloud Storage 存储桶”页面

  3. 选择您在上一部分创建的存储分区。

  4. 点击上传文件,然后选择要从本地机器上传到 Cloud Storage 存储桶的 demo-img.jpg 文件。

    “上传文件”按钮。
    这是您刚才上传的图片文件:
    雅加达骑自行车的两名女子。
    图片来源: Unsplash 用户 Rohiim Ariful

  5. 在文件上传完毕并显示在 Cloud Storage 存储桶中后,公开共享图片

  6. 试用此方法部分中,通过将 image.source.imageUri 字段中的 cloud-samples-data/vision 替换为所上传的 demo-img.jpg 文件所在的 Cloud Storage 存储桶的名称,完成交互式 API Explorer 模板。请求正文应如下所示:

    {
      "requests": [
        {
          "features": [
            {
              "type": "LABEL_DETECTION"
            }
          ],
          "image": {
            "source": {
              "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg"
            }
          }
        }
      ]
    }

  7. 点击执行 (Execute) 以向该服务发送请求。JSON 响应会显示在上方。

恭喜!您已经向 Cloud Vision API 服务发出了第一个 images.annotate 请求。

清理

为避免不必要的 Google Cloud Platform 费用,请使用 Google Cloud 控制台删除不需要的 Cloud Storage 存储桶(和项目)。

后续步骤