使用 API Explorer

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

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

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

开始之前

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

设置项目

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号，请注册一个新帐号。

  2. 在 Cloud Console 的项目选择器页面上，选择或创建 Cloud 项目。

    转到项目选择器页面

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

  4. 启用 Cloud Vision API。

    启用 API

创建 Cloud Storage 存储分区

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

    转到“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 模板。

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

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

清理

为了避免不必要的 Google Cloud Platform 费用，请在不需要时使用 Cloud Console 删除您的 Cloud Storage 存储分区（和您的项目）。

后续步骤