本快速入门将引导您逐步完成以下过程:
- 创建 Cloud Storage 存储分区。
- 将图片上传到 Cloud Storage 并将其公开。
- 向 Vision API 发出处理该图片的请求。
完成上述步骤需要大约 5 分钟。您每月可以免费在 Cloud Storage 中存储多达 5GB 的数据,并可以免费向 Vision API 发出多达 1000 个功能请求。
开始之前
如果您尚未设置项目并创建 Google Cloud Storage 存储分区,请首先按照下文所述进行操作。
设置项目
- 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。
-
确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。
- 启用 Cloud Vision API。
创建 Cloud Storage 存储分区
- 在 Cloud Console 中,转到浏览器页面。
- 点击创建存储分区。
- 在创建存储分区页面上,指定以下特性:
- 名称:唯一的存储分区名称。请勿在存储分区名称中添加敏感信息,因为存储分区命名空间是全局性的,公开可见。
- 默认存储类别: Standard
- 存储分区数据的存储位置。
- 点击创建。
向 Cloud Vision API 服务发出请求
下载
demo-img.jpg
。 (您可能需要右键点击该链接。)选择您在上一部分创建的存储分区。
点击上传文件,然后选择要从本地机器上传到 Cloud Storage 存储分区的
demo-img.jpg
文件。图片来源: Unsplash 用户 Rohiim Ariful。 在文件上传完毕并列在 Cloud Storage 浏览器中以后,公开共享图片。
通过将
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" } } } ] }
点击执行 (Execute) 以向该服务发送请求。JSON 响应会显示在上方。
恭喜!您已经向 Cloud Vision API 服务发出了第一个 images.annotate
请求。
清理
为了避免不必要的 Google Cloud Platform 费用,请在不需要时使用 Cloud Console 删除您的 Cloud Storage 存储分区(和您的项目)。
后续步骤
- 查看所有特征类型及其用途的列表。
- 通过 Vision API 客户端库,以您选择的语言开始使用 Vision API。
- 通过方法指南详细了解特定特征,查看示例注释以及获取单个文件或图片的注释。
- 了解批量图片和文件 (PDF/TIFF/GIF) 注释。
- 浏览客户端库代码示例的完整列表。
- 在社区教程页面浏览更具体的用例。