API 탐색기 사용

이 빠른 시작에서는 다음과 같은 작업 과정을 안내합니다.

  • Cloud Storage 버킷 만들기
  • 이미지를 Cloud Storage에 업로드하고 공개 상태로 설정
  • 해당 이미지로 Vision API에 요청 보내기

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

시작하기 전에

아직 프로젝트를 설정하고 Google Cloud Storage 버킷을 만들지 않은 경우 아래의 설명에 따라 지금 수행합니다.

프로젝트 설정

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Cloud Console의 프로젝트 선택기 페이지에서 Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Cloud Vision API를 사용 설정합니다.

    API 사용 설정

Cloud Storage 버킷 생성

  1. Cloud Console에서 Cloud Storage 브라우저 페이지로 이동합니다.

    Cloud Storage 브라우저 페이지로 이동

  2. 버킷 만들기를 클릭합니다.
  3. 버킷 만들기 대화상자에서 다음 속성을 지정합니다.
    • 이름: 고유한 버킷 이름입니다. 버킷 네임스페이스는 전역적이며 전체 공개로 표시되기 때문에 버킷 이름에 민감한 정보를 포함하면 안 됩니다.
    • 기본 스토리지 클래스: 스탠더드
    • 버킷 데이터를 저장할 위치입니다.
  4. 만들기를 클릭합니다.

Cloud Vision API 서비스에 요청 보내기

  1. demo-img.jpg를 다운로드합니다. 링크를 마우스 오른쪽 버튼으로 클릭해야 할 수 있습니다.

  2. Cloud Console 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 탐색기 템플릿을 완성합니다.

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

축하합니다 처음으로 Cloud Vision API 서비스에 images.annotate 요청을 보냈습니다.

삭제

불필요한 Google Cloud Platform 요금이 부과되지 않도록 하려면 Cloud Console을 사용하여 필요하지 않은 Cloud Storage 버킷과 해당 프로젝트를 삭제합니다.

다음 단계