Memulai Perspective API

Memulai Perspective API

Tentang codelab ini

Terakhir diperbarui Mar 10, 2022

Ditulis oleh Jigsaw

1. Sebelum memulai

Perspective API adalah API gratis yang membantu Anda menghosting percakapan online yang lebih baik. API tersebut menggunakan machine learning (ML) untuk menganalisis string teks dan memprediksi dampak yang dirasakan pada percakapan.

Dalam codelab ini, Anda akan menyiapkan Perspective API.

Catatan: Perspective API dimaksudkan untuk mempermudah moderasi konten. Hal ini tidak dimaksudkan untuk sepenuhnya menggantikan pekerjaan pembuat keputusan manusia.

Yang akan Anda pelajari

• Pendekatan yang didukung AI untuk moderasi yang melaporkan konten pada saat konten tersebut dibuat.

Yang Anda butuhkan

• Akun Google untuk akses ke Google Cloud
• Kecepatan internet yang baik

2. Mulai

Untuk memulai, Anda memerlukan project Google Cloud untuk mengautentikasi permintaan API.

1. Di Google Cloud Console, gunakan project yang sudah ada.
2. Jika perlu, ikuti langkah-langkah berikut untuk membuat project baru:

• Login dengan Akun Google Anda.
• Buka Cloud Console.
• Klik Create Project atau buka menu Select a Project lalu klik New Project dalam dialog.
• Beri nama project Anda, lalu klik Buat.

Project ini kini muncul di menu drop-down.

Meminta akses API

• Untuk meminta akses API, lengkapi formulir ini.

Dalam waktu satu jam, Anda akan menerima email yang mengonfirmasi bahwa Anda dapat melihat dan mengaktifkan API di Google Cloud.

Catatan: Jika Anda tidak menerima email dalam waktu satu hari kerja, lengkapi lagi formulirnya atau hubungi tim dukungan.

3. Mengaktifkan API

• Di Cloud Console, buka halaman Ringkasan API Perspektif, lalu klik Aktifkan.

4. Membuat kunci API

1. Di menu navigasi, klik API & Services > Credentials > Create credentials > API Key.

Catatan: Jika Anda membuat permintaan dari bahasa sisi klien seperti JavaScript, kunci API akan ditampilkan ke semua pengunjung. Sangat disarankan agar Anda melakukan proxy permintaan melalui server dan menerapkan pembatasan kunci sehingga kunci disembunyikan dari browser dan hanya server Anda yang dapat menggunakan kunci tersebut. Untuk informasi selengkapnya, lihat contoh cara mem-proxy permintaan melalui server dan rekomendasi keamanan kunci API lainnya.

Kunci API akan berfungsi dalam beberapa menit, tetapi juga dapat memerlukan waktu hingga satu jam. Sebelum proses ini selesai, Anda mungkin akan menerima pesan error.

2. Salin kunci API.

5. Contoh Permintaan

Anda dapat membuat library klien API dengan Library Klien Google API. Contoh ini menunjukkan cara menyiapkan library API dengan beberapa bahasa yang paling umum.

1. Buat permintaan AnalyzeComment.
2. Jalankan salah satu contoh panggilan API ini untuk mendapatkan skor langsung dari Perspective API.

Metode AnalyzeComment mengeluarkan permintaan API untuk menganalisis kolom comment.text untuk requestedAttributes, dalam hal ini model TOXICITY.

3. Tempelkan kunci API di kolom API_KEY.

Jika ingin, Anda dapat memanfaatkan flag doNotStore untuk memastikan bahwa semua komentar yang dikirim otomatis dihapus setelah skor ditampilkan.

4. Baca dokumentasi referensi API untuk mengetahui detail tentang semua kolom permintaan dan respons, serta nilai yang tersedia untuk requestedAttributes.

Ada atribut eksperimental, seperti OBSCENE, ATTACK_ON_DIRECTORY, dan SPAM yang juga dapat Anda gunakan.

Python

Contoh permintaan dan respons ini menggunakan versi Python Library Klien Google API.

1. Instal library klien Python.
2. Jalankan perintah berikut:

Anda akan melihat sesuatu seperti output ini:

Salam ramah Anda menerima skor toksisitas rendah.

Node.js

Contoh permintaan dan respons ini menggunakan versi Node.js dari Library Klien Google API.

1. Instal library klien Node.js atau instal paket npm googleapis.
2. Jalankan perintah berikut:

Anda akan melihat sesuatu seperti output ini:

cURL

Contoh permintaan dan respons ini menggunakan perintah cURL. Perintah ini akan berfungsi untuk sebagian besar pengguna MacOS dan Linux. Anda mungkin perlu menginstal cURL untuk menjalankan perintah ini.

• Ganti YOUR_KEY_HERE dengan kunci API Anda.

Dalam respons ini, kolom attributeScores.TOXICITY.summaryScore.value memberikan skor model toksisitas untuk komentar. Komentar tersebut mendapat skor 0,9 dari 1,0.

6. Selamat

Anda telah mengaktifkan dan menjalankan Perspective API.

Pelajari lebih lanjut

• Situs Perspective API berisi informasi selengkapnya tentang API, termasuk studi kasus.
• Situs developer Perspective API berisi informasi selengkapnya tentang atribut, bahasa, dan metode. Jika Anda ingin memulai dengan cepat, halaman Metode menjelaskan cara menggunakan metode AnalyzeComment dan SuggestCommentScore.