Perspective API 시작하기

1. 시작하기 전에

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

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

참고: 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를 클릭합니다.
• 프로젝트 이름을 지정한 다음 만들기를 클릭합니다.

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

API 액세스 요청

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

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

참고: 영업일 기준 1일 이내에 이메일을 받지 못하면 양식을 다시 작성하거나 지원팀에 문의하세요.

3. API 사용 설정

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

4. API 키 생성

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

참고: 자바스크립트와 같은 클라이언트 측 언어에서 요청하면 API 키는 모든 방문자에게 표시됩니다. 서버를 통해 요청을 프록시하고 키 제한을 적용하여 키가 브라우저에서 숨겨지고 서버에서만 이 키를 사용할 수 있도록 하는 것이 좋습니다. 자세한 내용은 서버를 통해 요청을 프록시하는 방법의 예시와 API 키 보안 권장사항을 참고하세요.

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

2. API 키를 복사합니다.

5. 샘플 요청

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

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

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

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

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

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

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

Python

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

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

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

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

Node.js

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

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

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

cURL

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

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

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

6. 축하합니다

Perspective API가 준비되었습니다.

자세히 알아보기

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