Apidog

Platform Pengembangan API Kolaboratif All-in-one

Desain API

Dokumentasi API

Debug API

Mocking API

Pengujian Otomatis API

Daftar gratis
UnduhUntuk Mac atau Linux
Home

/

Cara menggunakan API Perplexity AI dengan atau tanpa Akun Pro

Cara menggunakan API Perplexity AI dengan atau tanpa Akun Pro

Ardianto Nugroho

Ardianto Nugroho

Updated on April 17, 2025

Perplexity AI telah memperoleh popularitas yang signifikan karena kemampuan AI percakapannya, terutama kekuatannya dalam memberikan jawaban terkini yang dilengkapi sumber dengan mengintegrasikan pencarian web waktu nyata ke dalam responsnya. Bagi pengembang dan bisnis yang ingin memanfaatkan model-model kuat ini dalam aplikasi mereka sendiri, Perplexity menawarkan Antarmuka Pemrograman Aplikasi (API).

API Perplexity AI memungkinkan akses programatik ke model bahasa besar (LLM) Perplexity, termasuk model-model online mereka (seperti sonar-small-online dan sonar-medium-online) yang dapat menjelajahi web untuk menjawab pertanyaan, dan model obrolan offline mereka (seperti sonar-small-chat dan sonar-medium-chat).

Tutorial ini menjelajahi dua jalur utama untuk berinteraksi dengan ekosistem API Perplexity AI:

  1. Akses Langsung menggunakan Kunci API Resmi Perplexity: Ini adalah metode standar yang disediakan oleh Perplexity. Meskipun mungkin ada percobaan gratis atau kredit pengantar yang sangat terbatas, penggunaan berkelanjutan atau volume tinggi biasanya memerlukan langganan Perplexity Pro atau pengaturan perusahaan tertentu untuk mendapatkan dan menggunakan kunci API dengan kredit yang cukup.
  2. Akses Tidak Langsung melalui Layanan Pihak Ketiga (OpenRouter): Platform seperti OpenRouter bertindak sebagai agregator, menyediakan akses ke berbagai LLM, termasuk model-model Perplexity, melalui infrastruktur API mereka sendiri. Ini bisa menjadi cara alternatif untuk menggunakan model Perplexity, berpotensi tanpa perlu langganan Perplexity Pro langsung, meskipun Anda tetap akan dikenakan biaya melalui penyedia pihak ketiga.

Kami juga akan menjelaskan situasi terkait Groq, platform inferensi populer lainnya, dan hubungannya (atau ketidakhadirannya) dengan model-proprietary Perplexity.

Mengakses API Resmi Perplexity AI dengan Akun Pro

Bagian ini menjelaskan bagaimana menggunakan API resmi yang disediakan langsung oleh Perplexity. Metode ini biasanya menawarkan akses paling langsung dan berpotensi fitur atau model terbaru, tetapi biasanya memerlukan langganan Perplexity yang dibayar (Pro) untuk penggunaan yang berarti di luar eksplorasi awal.

Prasyarat:

  • Sebuah Akun Perplexity.
  • Sebuah langganan Perplexity Pro (umumnya diperlukan untuk akses API substansial dan pembuatan kunci).
  • Pemahaman dasar tentang REST API dan cara membuat permintaan HTTP (menggunakan alat seperti curl atau bahasa pemrograman seperti Python).

Langkah 1: Mendapatkan Kunci API Resmi Perplexity AI Anda

  1. Masuk ke Perplexity: Kunjungi situs web Perplexity (perplexity.ai) dan masuk ke akun Anda. Pastikan akun Anda telah ditingkatkan ke Pro jika diperlukan untuk pembuatan/penggunaan kunci API.
  2. Atur Metode Pembayaran: Cari pengaturan akun, opsi profil, atau bagian 'API' yang didedikasikan di dasbor Perplexity Anda. Lokasi tepatnya mungkin berubah, tetapi biasanya ditemukan di area manajemen akun Anda.

3. Buat Kunci API: Dalam pengaturan API, Anda harus menemukan opsi untuk menghasilkan kunci API baru. Klik tombol ini.

4. Salin dan Amankan Kunci Anda: Perplexity akan menghasilkan string alfanumerik unik. Ini adalah kunci API Anda. Perlakukan kunci ini seperti kata sandi. Jangan membagikannya secara publik atau memasukkannya langsung ke dalam repositori kode Anda. Simpan dengan aman, misalnya, menggunakan variabel lingkungan atau sistem manajemen rahasia.

Langkah 2: Memahami Endpoint API Perplexity AI

Endpoint utama untuk berinteraksi dengan model obrolan Perplexity melalui API adalah:

https://api.perplexity.ai/chat/completions

Endpoint ini mengikuti struktur yang mirip dengan API OpenAI, sehingga cukup familiar bagi pengembang yang telah bekerja dengan API LLM lainnya.

Langkah 3: Memilih Model API Perplexity AI

Perplexity menawarkan beberapa model melalui API-nya. Anda perlu menentukan model mana yang ingin Anda gunakan dalam permintaan API Anda. Model umum termasuk:

Model Online (dengan pencarian web):

  • sonar-small-online
  • sonar-medium-online
  • (Sebelumnya pplx-7b-online, pplx-70b-online - periksa dokumentasi saat ini untuk model yang tersedia)

Model Obrolan (tanpa pencarian web):

  • sonar-small-chat
  • sonar-medium-chat
  • (Sebelumnya pplx-7b-chat, pplx-70b-chat - periksa dokumentasi saat ini)
  • Model khusus lainnya atau model yang lebih lama juga mungkin tersedia. Selalu rujuk ke dokumentasi resmi API Perplexity untuk daftar model dan kemampuan mereka yang paling mutakhir.

Langkah 4: Membuat Permintaan API Perplexity AI Pertama Anda

Anda dapat berinteraksi dengan API menggunakan berbagai alat atau bahasa pemrograman. Berikut adalah contoh menggunakan curl (alat baris perintah) dan Python (requests library).

Dengan menggunakan curl:

curl -X POST <https://api.perplexity.ai/chat/completions> \\\\
     -H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY" \\\\
     -H "Content-Type: application/json" \\\\
     -d '{
       "model": "sonar-medium-online",
       "messages": [
         {
           "role": "system",
           "content": "Jadilah tepat dan ringkas."
         },
         {
           "role": "user",
           "content": "Apa manfaat utama menggunakan API Perplexity AI?"
         }
       ],
       "max_tokens": 500,
       "temperature": 0.7
     }'

Penjelasan:

  • curl -X POST ...: Membuat permintaan POST HTTP ke endpoint yang ditentukan.
  • H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY": Header ini menyediakan kredensial otentikasi Anda. Ganti YOUR_PERPLEXITY_API_KEY dengan kunci yang Anda hasilkan.
  • H "Content-Type: application/json": Memberitahu server bahwa body permintaan dalam format JSON.
  • d '{...}': Menentukan payload JSON (data) yang dikirim.
  • "model": Model Perplexity spesifik yang akan digunakan (misalnya, sonar-medium-online).
  • "messages": Daftar objek pesan yang mendefinisikan riwayat percakapan.
  • "role": Dapat berupa "system" (mengatur perilaku AI), "user" (input Anda), atau "assistant" (respons AI sebelumnya).
  • "content": Teks pesan.
  • "max_tokens" (opsional): Jumlah maksimum token yang akan dihasilkan dalam respons.
  • "temperature" (opsional): Mengontrol keacakan (0 = deterministik, lebih tinggi = lebih kreatif/acak).

Dengan menggunakan Python (requests library):

Pertama, pastikan Anda telah menginstal library requests: pip install requests

import requests
import json
import os

# Muat kunci API Anda dengan aman (misalnya, dari variabel lingkungan)
api_key = os.environ.get("PERPLEXITY_API_KEY")
# Atau hapus komentar dan ganti langsung (kurang aman untuk produksi):
# api_key = "YOUR_PERPLEXITY_API_KEY"

if not api_key:
    print("Error: Variabel lingkungan PERPLEXITY_API_KEY tidak disetel.")
else:
    url = "<https://api.perplexity.ai/chat/completions>"

    payload = {
        "model": "sonar-medium-online",
        "messages": [
            {
                "role": "system",
                "content": "Berikan penjelasan terperinci dan cantumkan sumber."
            },
            {
                "role": "user",
                "content": "Jelaskan konsep Generasi Augmented Retrieval (RAG)."
            }
        ],
        "max_tokens": 800,
        "temperature": 0.5,
        # Tambahkan parameter lain seperti 'frequency_penalty', 'presence_penalty' jika diperlukan
    }

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }

    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # Angkat pengecualian untuk kode status buruk (4xx atau 5xx)

        response_data = response.json()
        print(json.dumps(response_data, indent=2))

        # Ambil balasan asisten
        if response_data.get("choices"):
             assistant_message = response_data["choices"][0]["message"]["content"]
             print("\\\\nRespons Asisten:\\\\n", assistant_message)

    except requests.exceptions.RequestException as e:
        print(f"Terjadi kesalahan: {e}")
        if e.response is not None:
            print("Rincian kesalahan:", e.response.text)

Langkah 5: Menguji Kunci API Perplexity AI Anda dengan APIdog

Sebelum mengintegrasikan kunci API ke dalam aplikasi Anda, bijaksana untuk mengujinya agar memastikan bahwa itu berfungsi dengan benar. APIdog adalah alat yang ramah pengguna untuk menguji API. Berikut cara menggunakannya untuk menguji kunci Perplexity Anda:

Unduh dan Buka APIdog: Jalankan aplikasi APIdog atau gunakan versi webnya.

button

Buat Permintaan Baru: Klik tombol "+" atau opsi serupa untuk membuat permintaan API baru.

Atur Metode ke POST: Ubah dropdown metode HTTP ke POST.

Masukkan URL Endpoint: Di kolom input URL, tempel endpoint penyelesaian obrolan Perplexity: https://api.perplexity.ai/chat/completions

Konfigurasi Otorisasi:

  • Pergi ke tab 'Authorization' di bawah bilah URL.
  • Pilih 'Bearer Token' dari dropdown tipe.
  • Di kolom 'Token', tempel kunci API Perplexity AI Anda yang diperoleh di Langkah 1.

Atur Header Content-Type:

  • Pergi ke tab 'Headers'.
  • Tambahkan header baru. Atur kuncinya ke Content-Type dan nilainya ke application/json.

Membangun Body Permintaan:

  • Pergi ke tab 'Body'.
  • Pilih opsi 'raw' dan pilih 'JSON' dari dropdown di sampingnya.
  • Tempel struktur JSON berikut ke dalam area teks, mengganti "sonar-medium-online" dengan model yang ingin Anda uji dan menyesuaikan "content" jika diinginkan:
{
  "model": "sonar-medium-online",
  "messages": [
    {
      "role": "system",
      "content": "Jadilah tepat dan faktual."
    },
    {
      "role": "user",
      "content": "Berapa banyak bulan yang dimiliki Mars?"
    }
  ]
}

Kirim Permintaan: Klik tombol 'Kirim'.

Periksa Respons: APIdog akan menampilkan respons dari API Perplexity. Cari kode status 200 OK dan respons JSON yang berisi jawaban AI di bidang choices[0].message.content. Jika Anda mendapatkan kesalahan (seperti 401 Unauthorized atau 403 Forbidden), periksa kembali bahwa kunci API Anda telah ditempel dengan benar di tab Otorisasi dan bahwa akun/kunci Perplexity Anda memiliki izin dan kredit yang diperlukan.

💡
Ingin alat Pengujian API yang hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform terintegrasi, All-in-One untuk Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

APIdog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
button

Menggunakan Model API Perplexity AI Tanpa Akun Pro Langsung (dengan Openrouter)

Jika Anda tidak memiliki langganan Perplexity Pro atau lebih suka model penagihan/akses yang berbeda, Anda sering kali dapat menggunakan model Perplexity melalui penyedia API pihak ketiga. OpenRouter adalah contoh populer.

OpenRouter menyediakan endpoint API terpadu untuk mengakses berbagai LLM dari berbagai penyedia, termasuk Perplexity. Anda membayar OpenRouter berdasarkan penggunaan Anda, dan mereka menangani panggilan backend ke penyedia model yang bersangkutan.

Anda dapat memeriksa API Perplexity AI yang tersedia di sini:

Prasyarat:

  • Sebuah Akun OpenRouter (openrouter.ai).
  • Pendanaan ditambahkan ke akun OpenRouter Anda atau mengatur penagihan.
  • Pemahaman dasar tentang REST API.

Langkah 1: Dapatkan Kunci API OpenRouter Anda

  1. Daftar/Masuk: Kunjungi openrouter.ai dan buat akun atau masuk.
  2. Navigasi ke Kunci: Temukan bagian 'Kunci' atau 'Kunci API' di pengaturan akun Anda.
  3. Buat Kunci: Hasilkan kunci API baru.
  4. Salin dan Amankan: Salin kunci yang dihasilkan dan simpan dengan aman, sama seperti kunci Perplexity resmi.

Langkah 2: Identifikasi Model API Perplexity AI di OpenRouter

OpenRouter menggunakan konvensi penamaan mereka sendiri, sering kali menambahkan awalan nama penyedia. Model Perplexity di OpenRouter mungkin terlihat seperti:

  • perplexity/sonar-small-chat
  • perplexity/sonar-small-online
  • perplexity/sonar-medium-chat
  • perplexity/sonar-medium-online
  • (Periksa halaman /models OpenRouter untuk daftar dan nama yang tepat saat ini)

Langkah 3: Buat Permintaan API melalui Endpoint OpenRouter untuk Model API Perplexity AI

OpenRouter menggunakan endpoint API yang kompatibel dengan OpenAI:

https://openrouter.ai/api/v1/chat/completions

Anda menyusun permintaan Anda mirip dengan API resmi Perplexity atau API OpenAI, tetapi menggunakan kunci OpenRouter Anda dan nama model OpenRouter.

Dengan menggunakan curl:

curl -X POST <https://openrouter.ai/api/v1/chat/completions> \\\\
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \\\\
  -H "Content-Type: application/json" \\\\
  -H "HTTP-Referer: YOUR_SITE_URL" \\\\ # Opsional, tetapi direkomendasikan oleh OpenRouter
  -H "X-Title: YOUR_APP_NAME" \\\\      # Opsional, tetapi direkomendasikan oleh OpenRouter
  -d '{
    "model": "perplexity/sonar-medium-online",
    "messages": [
      {"role": "user", "content": "Bagaimana OpenRouter memberikan akses ke model API Perplexity AI?"}
    ]
  }'

Catatan: OpenRouter merekomendasikan menambahkan header HTTP-Referer dan X-Title untuk mengidentifikasi aplikasi Anda. Ganti YOUR_OPENROUTER_API_KEY, YOUR_SITE_URL, dan YOUR_APP_NAME sesuai kebutuhan.

Langkah 4: Menangani Respons OpenRouter untuk Model API Perplexity AI

Struktur respons dari OpenRouter umumnya identik dengan standar OpenAI/Perplexity, termasuk bidang choices, message, content, dan usage. Perbedaan utama adalah bahwa biaya dihitung berdasarkan harga OpenRouter untuk model Perplexity spesifik yang Anda gunakan.

Manfaat menggunakan OpenRouter:

  • Akses model Perplexity tanpa perlu langganan Perplexity Pro langsung.
  • Penagihan terpusat untuk beberapa LLM dari berbagai penyedia.
  • Satu kunci API dan endpoint untuk berbagai model.

Pertimbangan:

  • Harga mungkin berbeda dari biaya API langsung Perplexity.
  • Pemungkinan latensi sedikit lebih tinggi karena tambahan hop.
  • Terikat pada ketersediaan platform OpenRouter dan integrasi mereka dengan Perplexity.

Kesimpulan

Tutorial ini memberikan panduan terperinci untuk mengakses model kuat di balik Perplexity AI melalui berbagai metode API. Ingatlah untuk selalu merujuk pada dokumentasi resmi untuk Perplexity, OpenRouter untuk nama model, endpoint, harga, dan fitur yang paling mutakhir. Amankan kunci API Anda dan pilih metode akses yang paling sesuai dengan kebutuhan proyek dan anggaran Anda.