使用 API Explorer

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

  • 创建 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. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能

  4. 启用 Cloud Vision API。

    启用 API

创建 Cloud Storage 存储分区

  1. 在 Cloud Console 中,转到浏览器页面。

    转到浏览器

  2. 点击创建存储分区
  3. 创建存储分区页面上,指定以下特性:
    • 名称:唯一的存储分区名称。请勿在存储分区名称中添加敏感信息,因为存储分区命名空间是全局性的,公开可见。
    • 默认存储类别Standard
    • 存储分区数据的存储位置。
  4. 点击创建

向 Cloud Vision API 服务发出请求

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

  2. 打开 Cloud Console 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 费用,请在不需要时使用 Cloud Console 删除您的 Cloud Storage 存储分区(和您的项目)。

后续步骤