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

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

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

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

시작하기 전에

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

프로젝트 설정

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  4. Enable the Cloud Vision API.

    Enable the API

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

    Go to project selector

  6. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  7. Enable the Cloud Vision API.

    Enable the API

Cloud Storage 버킷 만들기

  1. Google Cloud Console에서 Cloud Storage 버킷 페이지로 이동합니다.

    버킷 페이지로 이동

  2. 버킷 만들기를 클릭합니다.
  3. 버킷 만들기 페이지에서 버킷 정보를 입력합니다. 다음 단계로 이동하려면 계속을 클릭합니다.
    • 버킷 이름 지정에서 고유한 버킷 이름을 입력합니다. 버킷 네임스페이스는 전역적이며 공개로 표시되므로 버킷 이름에 민감한 정보를 포함해서는 안 됩니다.
    • 데이터를 저장할 위치 선택에서 다음을 수행합니다.
      • 위치 유형 옵션을 선택합니다.
      • 위치 옵션을 선택합니다.
    • 데이터의 기본 스토리지 클래스 선택에서 다음을 선택합니다. 표준.
    • 객체 액세스를 제어하는 방식 선택에서 액세스 제어 옵션을 선택합니다.
    • 고급 설정(선택사항)에서 암호화 방법, 보관 정책 또는 버킷 라벨을 지정합니다.
  4. 만들기를 클릭합니다.

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/visiondemo-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) 주석에 대해 알아보세요.
  • 클라이언트 라이브러리 코드 샘플의 전체 목록을 확인하세요.