使用 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

    5.

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

    转到“项目选择器”

  6. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。

  7. 启用 Cloud Vision API。

    启用 API

    8.

创建 Cloud Storage 存储分区

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

    转到浏览器

  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 存储分区（和您的项目）。

后续步骤