Cloud Vision API를 사용하여 이미지에서 라벨 인식

Cloud Vision API를 사용하여 이미지에서 라벨 인식

이 빠른 시작에서는 다음 방법을 보여줍니다.

• Cloud Storage 버킷 만들기
• Cloud Storage에 이미지를 업로드하고 파일을 공개적으로 액세스할 수 있도록 설정합니다.
• 해당 이미지로 Vision API에 요청 수행

이 단계를 완료하는 데 5분 정도 걸립니다. Cloud Storage에 무료로 최대 5GB의 데이터를 저장하고, Vision API에 무료로 매달 최대 1,000건의 기능 요청을 보낼 수 있습니다.

시작하기 전에

아직 설정하지 않았다면 다음 안내에 따라 프로젝트를 설정하고 Cloud Storage 버킷을 만듭니다.

프로젝트 설정

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Vision API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Vision API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Cloud Storage 버킷 만들기

1. In the Google Cloud console, go to the Cloud Storage Buckets page.

   Go to Buckets

2. Click Create.
3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
   1. For Name your bucket, enter a unique bucket name. Don't include sensitive information in the bucket name, because the bucket namespace is global and publicly visible.
   2. In the Choose where to store your data section, do the following:
      1. Select a Location type.
      2. Choose a location where your bucket's data is permanently stored from the Location type drop-down menu.
         • If you select the dual-region location type, you can also choose to enable turbo replication by using the relevant checkbox.
      3. To set up cross-bucket replication, select Add cross-bucket replication via Storage Transfer Service and follow these steps:

         Set up cross-bucket replication

         1. In the Bucket menu, select a bucket.

         2. In the Replication settings section, click Configure to configure settings for the replication job.

            The Configure cross-bucket replication pane appears.

            • To filter objects to replicate by object name prefix, enter a prefix that you want to include or exclude objects from, then click Add a prefix.
            • To set a storage class for the replicated objects, select a storage class from the Storage class menu. If you skip this step, the replicated objects will use the destination bucket's storage class by default.
            • Click Done.
   3. In the Choose how to store your data section, do the following:
      1. In the Set a default class section, select the following: Standard.
      2. To enable hierarchical namespace, in the Optimize storage for data-intensive workloads section, select Enable hierarchical namespace on this bucket.
         Note: You cannot enable hierarchical namespace in existing buckets.
   4. In the Choose how to control access to objects section, select whether or not your bucket enforces public access prevention, and select an access control method for your bucket's objects.
      Note: You cannot change the Prevent public access setting if this setting is enforced at an organization policy.
   5. In the Choose how to protect object data section, do the following:
      • Select any of the options under Data protection that you want to set for your bucket.
        • To enable soft delete, click the Soft delete policy (For data recovery) checkbox, and specify the number of days you want to retain objects after deletion.
        • To set Object Versioning, click the Object versioning (For version control) checkbox, and specify the maximum number of versions per object and the number of days after which the noncurrent versions expire.
        • To enable the retention policy on objects and buckets, click the Retention (For compliance) checkbox, and then do the following:
          • To enable Object Retention Lock, click the Enable object retention checkbox.
          • To enable Bucket Lock, click the Set bucket retention policy checkbox, and choose a unit of time and a length of time for your retention period.
      • To choose how your object data will be encrypted, expand the Data encryption section (), and select a Data encryption method.
4. Click Create.

Cloud Vision에 요청 수행

1. 샘플 이미지 파일의 로컬 버전을 저장합니다(demo-img.jpg).

2. Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.

   버킷으로 이동

3. 이전 섹션에서 만든 버킷을 선택합니다.

4. 파일 업로드를 클릭하고 demo-img.jpg 파일의 로컬 버전을 선택하여 Cloud Storage 버킷에 업로드합니다.

   

   방금 업로드한 이미지 파일입니다.

   

   이미지 출처: Rohiim Ariful(Unsplash)

5. 파일이 업로드되어 Cloud Storage 버킷에 표시되면 이미지를 공개적으로 공유합니다.

6. 이 메서드 사용해 보기 섹션에서 image.source.imageUri 필드의 cloud-samples-data/vision을 demo-img.jpg 파일을 업로드한 Cloud Storage 버킷 이름으로 바꿔서 대화형 API 탐색기 템플릿을 완료합니다. 요청 본문은 다음과 같이 표시됩니다.

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

7. 실행을 클릭하여 서비스에 요청을 보냅니다. JSON 응답은 요청 본문 뒤에 표시됩니다.

수고하셨습니다. Cloud Vision에 첫 번째 images.annotate 요청을 수행했습니다.

삭제

불필요한 Google Cloud 요금이 청구되지 않게 하려면 필요하지 않은 경우 Google Cloud 콘솔을 사용하여 Cloud Storage 버킷 및 프로젝트를 삭제합니다.

다음 단계

• 모든 기능 유형과 그 용도에 대한 목록을 참조하세요.
• Vision API 클라이언트 라이브러리를 사용하여 Vision API를 원하는 언어로 시작하세요.
• 안내 가이드를 사용하여 특정 기능에 대해 자세히 알아보고, 예시 주석을 참조하고, 개별 파일이나 이미지에 대한 주석을 가져오세요.
• 배치 이미지 및 파일(PDF/TIFF/GIF) 주석에 대해 알아보세요.
• 클라이언트 라이브러리 코드 샘플의 전체 목록을 확인하세요.