Perspective API 시작하기

Perspective API 시작하기

이 Codelab 정보

subject최종 업데이트: 3월 10, 2022
account_circle작성자: Jigsaw

1. 시작하기 전에

Perspective API는 온라인에서 더 나은 대화를 주최하는 데 도움이 되는 무료 API입니다. API는 머신러닝 (ML)을 사용하여 텍스트 문자열을 분석하고 대화에 미칠 수 있는 영향을 예측합니다.

이 Codelab에서는 Perspective API를 설정합니다.

학습할 내용

  • 콘텐츠를 만드는 순간에 플래그를 지정하는 AI 기반 검토 방식입니다.

필요한 항목

  • Google Cloud에 액세스하기 위한 Google 계정
  • 안정적인 인터넷 속도

2. 시작하기

시작하려면 API 요청을 인증할 Google Cloud 프로젝트가 필요합니다.

  1. Google Cloud Console에서 기존 프로젝트를 사용합니다.
  2. 필요한 경우 다음 단계에 따라 새 프로젝트를 만듭니다.
  • Google 계정으로 로그인합니다.
  • Cloud Console을 엽니다.
  • Create Project를 클릭하거나 Select a Project 메뉴를 열고 대화상자에서 New Project를 클릭합니다.
  • 프로젝트 이름을 지정한 다음 만들기를 클릭합니다.

ba7a5088d7d0047e.png

드롭다운 메뉴에 프로젝트가 나타납니다.

API 액세스 요청

  • API 액세스를 요청하려면 이 양식을 작성하세요.

1시간 이내에 Google Cloud에서 API를 보고 사용 설정할 수 있음을 확인하는 이메일이 전송됩니다.

3. API 사용 설정

  • Cloud Console에서 Perspective API 개요 페이지로 이동한 다음 사용 설정을 클릭합니다.

4. API 키 생성

  1. 탐색 메뉴에서 API 및 AMP, 서비스 및 기타 사용자 인증 정보, 사용자 인증 정보 만들기 및 API 키를 클릭합니다.

8ab64b6d9822c219.png

API 키는 몇 분 이내에 작동하지만 최대 1시간이 걸릴 수 있습니다. 그때까지는 오류 메시지가 표시될 수 있습니다.

  1. API 키를 복사합니다.

43fb6b1cf99a4e16.png

5. 샘플 요청

Google API 클라이언트 라이브러리를 사용하여 API 클라이언트 라이브러리를 생성할 수 있습니다. 이 예에서는 가장 일반적인 언어로 API 라이브러리를 설정하는 방법을 보여줍니다.

  1. AnalyzeComment 요청을 실행합니다.
  2. 샘플 API 호출 중 하나를 실행하여 Perspective API에서 직접 점수를 받으세요.

AnalyzeComment 메서드는 requestedAttributes의 comment.text 필드(이 경우에는 TOXICITY 모델)를 분석하는 API 요청을 실행합니다.

  1. API 키를 API_KEY 필드에 붙여넣습니다.

원하는 경우 doNotStore 플래그를 활용하여 제출된 모든 댓글이 점수를 반환한 후 자동으로 삭제되도록 할 수 있습니다.

  1. 모든 요청 및 응답 필드에 대한 자세한 내용과 requestedAttributes에 사용할 수 있는 값은 API 참조 문서를 참고하세요.

사용할 수 있는 실험 속성(예: OBSCENE, ATTACK_ON_COMMENTER, SPAM)도 있습니다.

Python

이 샘플 요청 및 응답은 Google API 클라이언트 라이브러리의 Python 버전을 사용합니다.

  1. Python 클라이언트 라이브러리 설치
  2. 다음 명령어를 실행합니다.

ad3fa8068f953ae9.png

다음과 같은 출력이 표시됩니다.

961ee26edcfd6cd0.png

인사말에 부정적인 점수가 표시되었습니다.

Node.js

이 샘플 요청 및 응답은 Google API 클라이언트 라이브러리의 Node.js 버전을 사용합니다.

  1. Node.js 클라이언트 라이브러리를 설치하거나 npm 패키지 googleapis를 설치합니다.
  2. 다음 명령어를 실행합니다.

34c914e027ff0225.png

다음과 같은 출력이 표시됩니다.

d6a18c7233a51a77.png

cURL

이 샘플 요청 및 응답은 cURL 명령어를 사용합니다. 이 명령어는 대부분의 MacOS 및 Linux 사용자에게 적용됩니다. 이 명령어를 실행하려면 cURL을 설치해야 할 수 있습니다.

  • YOUR_KEY_HERE를 API 키로 변경합니다.

327f1e3f1faf92a8.png

이 응답에서 attributeScores.TOXICITY.summaryScore.value 필드는 댓글에 대한 악성 모델 점수를 제공합니다. 이 댓글은 1.0점에서 0.9점을 받았습니다.

1977c2bbb5343d93.png

6. 축하합니다

Perspective API가 준비되었습니다.

자세히 알아보기

  • Perspective API 웹사이트에는 우수사례를 비롯하여 API에 대한 자세한 정보가 포함되어 있습니다.
  • Perspective API 개발자 웹사이트에는 속성, 언어, 메서드에 관한 자세한 정보가 나와 있습니다. 빠르게 시작하려면 메서드 페이지에서 AnalyzeComment 및 SuggestCommentScore 메서드를 사용하는 방법을 알아보세요.
bug_report 오류 신고