Perplexity AI API - Documents

Base Information

BASE_URL_API: https://api.maelyn.eu
Path / Endpoint: /ai/perplexity
Full URL: https://api.maelyn.eu/ai/perplexity
Method: POST
Credit Usage: 5

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk mengirim prompt ke Perplexity AI dan mendapatkan jawaban beserta sumber referensi.

{
  "prompt": "Apa itu black hole?",
  "model": "sonar-pro"
}

Body Parameters

Name	Type	Required	Description
`prompt`	`string`	Yes*	Prompt utama untuk AI
`query`	`string`	Yes*	Alternatif dari `prompt`
`text`	`string`	Yes*	Alternatif dari `prompt`
`model`	`string`	No	Model Perplexity yang digunakan (default: `sonar-pro`)

Salah satu dari prompt, query, atau text wajib diisi.

Example Usage

{
  "prompt": "Apa itu black hole?",
  "model": "sonar-pro"
}

Success Response

{
  "success": true,
  "model": "sonar-pro",
  "result": {
    "answer": "Black hole adalah wilayah di ruang angkasa dengan gravitasi yang sangat kuat sehingga cahaya pun tidak dapat lolos.",
    "source": [
      "https://example.com/source-1",
      "https://example.com/source-2"
    ]
  }
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Prompt Required

{
  "success": false,
  "error": "PROMPT_REQUIRED",
  "message": "Field prompt wajib diisi"
}

Upstream API Error

{
  "success": false,
  "error": "UPSTREAM_API_ERROR",
  "message": "Gagal mengambil respon dari Perplexity"
}

Empty AI Response

{
  "success": false,
  "error": "EMPTY_AI_RESPONSE",
  "message": "Perplexity tidak mengembalikan jawaban"
}

Request Timeout

{
  "success": false,
  "error": "REQUEST_TIMEOUT",
  "message": "Server Perplexity terlalu lama merespon"
}

Fetch Failed

{
  "success": false,
  "error": "FETCH_FAILED",
  "message": "Terjadi gangguan saat menghubungi server Perplexity"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Playground

Groq Image