Apidog

Nền tảng phát triển API hợp tác tất cả trong một

Thiết kế API

Tài liệu API

Gỡ lỗi API

Giả lập API

Kiểm thử API tự động

Cách sử dụng API Perplexity AI với hoặc không có tài khoản Pro

Minh Triết

Minh Triết

Updated on tháng 4 17, 2025

Perplexity AI đã đạt được sự phổ biến đáng kể nhờ khả năng AI hội thoại của nó, đặc biệt là sức mạnh trong việc cung cấp các câu trả lời cập nhật, có nguồn gốc được ghi nhận bằng cách tích hợp tìm kiếm web thời gian thực vào các phản hồi của nó. Đối với các nhà phát triển và doanh nghiệp đang tìm cách tận dụng những mô hình mạnh mẽ này trong ứng dụng của riêng họ, Perplexity cung cấp Giao diện Lập trình Ứng dụng (API).

API Perplexity AI cho phép truy cập lập trình vào các mô hình ngôn ngữ lớn (LLM) của Perplexity, bao gồm các mô hình trực tuyến của họ (như sonar-small-onlinesonar-medium-online) có thể duyệt web để trả lời các truy vấn, và các mô hình chat ngoại tuyến của họ (như sonar-small-chatsonar-medium-chat).

Bài hướng dẫn này khám phá hai con đường chính để tương tác với hệ sinh thái API Perplexity AI:

  1. Truy cập trực tiếp bằng cách sử dụng Khóa API Perplexity Chính thức: Đây là phương pháp tiêu chuẩn được cung cấp bởi Perplexity. Mặc dù có thể có một số lượng hạn chế bản dùng thử miễn phí hoặc các khoản tín dụng khởi đầu, nhưng việc sử dụng kéo dài hoặc khối lượng lớn thông thường yêu cầu đăng ký Perplexity Pro hoặc các thỏa thuận doanh nghiệp cụ thể để nhận và sử dụng một khóa API với đủ tín dụng.
  2. Truy cập gián tiếp qua Dịch vụ Bên thứ Ba (OpenRouter): Các nền tảng như OpenRouter đóng vai trò là trung gian, cung cấp truy cập vào nhiều LLM khác nhau, bao gồm các mô hình của Perplexity, thông qua cơ sở hạ tầng API riêng của họ. Đây có thể là một cách thay thế để sử dụng các mô hình Perplexity, có thể mà không cần đến một đăng ký trực tiếp Perplexity Pro, mặc dù bạn vẫn sẽ chịu chi phí thông qua nhà cung cấp bên thứ ba.

Chúng tôi cũng sẽ làm rõ tình hình liên quan đến Groq, một nền tảng suy diễn phổ biến khác, và mối quan hệ (hoặc thiếu mối quan hệ) của nó với các mô hình độc quyền của Perplexity.


Truy cập API Perplexity AI Chính thức với Tài khoản Pro

Phần này chi tiết cách sử dụng API chính thức được cung cấp trực tiếp bởi Perplexity. Phương pháp này thường cung cấp quyền truy cập trực tiếp nhất và có thể là các tính năng hoặc mô hình mới nhất, nhưng thường yêu cầu một đăng ký trả phí Perplexity (Pro) cho việc sử dụng có ý nghĩa hơn ngoài việc khám phá ban đầu.

Các yêu cầu tiên quyết:

  • Một Tài khoản Perplexity.
  • Một đăng ký Perplexity Pro (thường yêu cầu cho việc truy cập API lớn và tạo khóa).
  • Hiểu biết cơ bản về REST API và cách gửi yêu cầu HTTP (sử dụng các công cụ như curl hoặc ngôn ngữ lập trình như Python).

Bước 1: Nhận Khóa API Perplexity AI Chính thức của Bạn

  1. Đăng nhập vào Perplexity: Truy cập trang web Perplexity (perplexity.ai) và đăng nhập vào tài khoản của bạn. Đảm bảo nâng cấp lên Pro nếu cần thiết cho việc tạo/sử dụng khóa API.
  2. Thiết lập phương thức thanh toán: Tìm kiếm cài đặt tài khoản, tùy chọn hồ sơ, hoặc một phần 'API' dành riêng trong bảng điều khiển Perplexity của bạn. Vị trí chính xác có thể thay đổi, nhưng thường được tìm thấy dưới khu vực quản lý tài khoản của bạn.

3. Tạo Khóa API: Trong cài đặt API, bạn sẽ tìm thấy một tùy chọn để tạo một khóa API mới. Nhấn nút này.

4. Sao chép và Bảo mật Khóa của Bạn: Perplexity sẽ tạo ra một chuỗi ký tự alphanumeric duy nhất. Đây là khóa API của bạn. Xử lý khóa này như một mật khẩu. Không chia sẻ công khai hoặc đưa trực tiếp vào các kho mã của bạn. Lưu trữ nó một cách an toàn, chẳng hạn như bằng cách sử dụng biến môi trường hoặc một hệ thống quản lý bí mật.

Bước 2: Hiểu về Điểm cuối API Perplexity AI

Điểm cuỗi chính để tương tác với các mô hình chat của Perplexity thông qua API là:

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

Điểm cuối này theo cấu trúc tương tự như API của OpenAI, khiến nó khá quen thuộc với các nhà phát triển đã làm việc với các API LLM khác.

Bước 3: Chọn một Mô hình API Perplexity AI

Perplexity cung cấp nhiều mô hình thông qua API của mình. Bạn cần chỉ định mô hình nào bạn muốn sử dụng trong yêu cầu API của bạn. Các mô hình thông thường bao gồm:

Mô hình Trực tuyến (có tìm kiếm web):

  • sonar-small-online
  • sonar-medium-online
  • (Trước đây là pplx-7b-online, pplx-70b-online - kiểm tra tài liệu hiện tại để có danh sách mô hình có sẵn)

Mô hình Chat (không có tìm kiếm web):

  • sonar-small-chat
  • sonar-medium-chat
  • (Trước đây là pplx-7b-chat, pplx-70b-chat - kiểm tra tài liệu hiện tại)
  • Các mô hình chuyên biệt hoặc cũ hơn khác cũng có thể có. Luôn tham khảo tài liệu API Perplexity chính thức để có danh sách mô hình và khả năng cập nhật nhất.

Bước 4: Thực hiện Yêu cầu API Perplexity AI Đầu tiên của Bạn

Bạn có thể tương tác với API bằng nhiều công cụ hoặc ngôn ngữ lập trình khác nhau. Dưới đây là các ví dụ sử dụng curl (công cụ dòng lệnh) và Python (requests thư viện).

Sử dụng 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": "Hãy chính xác và ngắn gọn."
         },
         {
           "role": "user",
           "content": "Những lợi ích chính của việc sử dụng API Perplexity AI là gì?"
         }
       ],
       "max_tokens": 500,
       "temperature": 0.7
     }'

Giải thích:

  • curl -X POST ...: Thực hiện yêu cầu POST HTTP đến điểm cuối được chỉ định.
  • H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY": Tiêu đề này cung cấp thông tin xác thực của bạn. Thay YOUR_PERPLEXITY_API_KEY bằng khóa bạn đã tạo.
  • H "Content-Type: application/json": Thông báo cho máy chủ rằng nội dung yêu cầu là định dạng JSON.
  • d '{...}': Chỉ định nội dung JSON (dữ liệu) đang được gửi.
  • "model": Mô hình Perplexity cụ thể để sử dụng (ví dụ, sonar-medium-online).
  • "messages": Danh sách các đối tượng tin nhắn định nghĩa lịch sử cuộc trò chuyện.
  • "role": Có thể là "system" (đặt hành vi của AI), "user" (đầu vào của bạn), hoặc "assistant" (các phản hồi trước đây của AI).
  • "content": Nội dung văn bản của tin nhắn.
  • "max_tokens" (tùy chọn): Số lượng tối đa token để tạo trong phản hồi.
  • "temperature" (tùy chọn): Kiểm soát tính ngẫu nhiên (0 = xác định, cao hơn = sáng tạo/ngẫu nhiên hơn).

Sử dụng Python (requests thư viện):

Trước tiên, hãy chắc chắn rằng bạn đã cài đặt thư viện requests: pip install requests

import requests
import json
import os

# Tải an toàn khóa API của bạn (ví dụ, từ một biến môi trường)
api_key = os.environ.get("PERPLEXITY_API_KEY")
# Hoặc bỏ chú thích và thay thế trực tiếp (ít an toàn hơn cho sản xuất):
# api_key = "YOUR_PERPLEXITY_API_KEY"

if not api_key:
    print("Lỗi: Biến môi trường PERPLEXITY_API_KEY chưa được thiết lập.")
else:
    url = "<https://api.perplexity.ai/chat/completions>"

    payload = {
        "model": "sonar-medium-online",
        "messages": [
            {
                "role": "system",
                "content": "Cung cấp giải thích chi tiết và ghi nguồn."
            },
            {
                "role": "user",
                "content": "Giải thích khái niệm Tạo ra Thông tin Đặc biệt (RAG)."
            }
        ],
        "max_tokens": 800,
        "temperature": 0.5,
        # Thêm các tham số khác như 'frequency_penalty', 'presence_penalty' nếu cần.
    }

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

    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # Ném ra ngoại lệ cho mã trạng thái xấu (4xx hoặc 5xx)

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

        # Lấy phản hồi của trợ lý
        if response_data.get("choices"):
             assistant_message = response_data["choices"][0]["message"]["content"]
             print("\\\\nPhản hồi của Trợ lý:\\\\n", assistant_message)

    except requests.exceptions.RequestException as e:
        print(f"Đã xảy ra lỗi: {e}")
        if e.response is not None:
            print("Chi tiết lỗi:", e.response.text)

Bước 5: Kiểm tra Khóa API Perplexity AI của Bạn với APIdog

Trước khi tích hợp khóa API vào ứng dụng của bạn, nên kiểm tra nó để đảm bảo rằng nó hoạt động chính xác. APIdog là một công cụ thân thiện với người dùng để kiểm tra API. Đây là cách sử dụng nó để kiểm tra khóa Perplexity của bạn:

Tải xuống và Mở APIdog: Khởi động ứng dụng APIdog hoặc sử dụng phiên bản web.

button

Tạo Yêu cầu Mới: Nhấp vào nút "+" hoặc tùy chọn tương tự để tạo yêu cầu API mới.

Đặt Phương thức thành POST: Thay đổi menu thả phương thức HTTP thành POST.

Nhập URL Điểm cuối: Trong ô nhập URL, dán điểm cuối hoàn tất trò chuyện Perplexity: https://api.perplexity.ai/chat/completions

Cấu hình Ủy quyền:

  • Đi tới tab 'Authorization' bên dưới thanh URL.
  • Chọn 'Bearer Token' từ menu thả loại.
  • Trong ô 'Token', dán khóa API Perplexity AI mà bạn đã nhận được ở Bước 1.

Đặt Tiêu đề Kiểu Nội dung:

  • Đi tới tab 'Headers'.
  • Thêm một tiêu đề mới. Đặt khóa thành Content-Type và giá trị là application/json.

Xây dựng Thân Yêu cầu:

  • Đi tới tab 'Body'.
  • Chọn tùy chọn 'raw' và chọn 'JSON' từ menu thả bên cạnh.
  • Dán cấu trúc JSON sau vào vùng văn bản, thay thế "sonar-medium-online" bằng mô hình bạn muốn thử và điều chỉnh "content" nếu mong muốn:
{
  "model": "sonar-medium-online",
  "messages": [
    {
      "role": "system",
      "content": "Hãy chính xác và cụ thể."
    },
    {
      "role": "user",
      "content": "Mars có bao nhiêu mặt trăng?"
    }
  ]
}

Gửi Yêu cầu: Nhấp vào nút 'Gửi'.

Kiểm tra Phản hồi: APIdog sẽ hiển thị phản hồi từ API Perplexity. Tìm mã trạng thái 200 OK và phản hồi JSON chứa câu trả lời AI trong trường choices[0].message.content. Nếu bạn nhận được lỗi (như 401 Unauthorized hoặc 403 Forbidden), hãy kiểm tra lại xem khóa API của bạn đã được dán chính xác trong tab Ủy quyền và tài khoản/khóa Perplexity của bạn có đủ quyền và tín dụng cần thiết không.

💡
Bạn có muốn một công cụ Kiểm tra API tuyệt vời mà tạo ra tài liệu API đẹp mắt?

Bạn có muốn một nền tảng Tích hợp, Tất cả trong Một cho Nhóm Phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng tất cả nhu cầu của bạn, và thay thế Postman với mức giá hợp lý hơn nhiều!
button

Sử dụng Các Mô hình API Perplexity AI mà không cần Tài khoản Pro Trực tiếp (với OpenRouter)

Nếu bạn không có đăng ký Perplexity Pro hoặc thích một mô hình thanh toán/truy cập khác, bạn thường có thể sử dụng các mô hình của Perplexity thông qua các nhà cung cấp API bên thứ ba. OpenRouter là một ví dụ phổ biến.

OpenRouter cung cấp một điểm cuối API thống nhất để truy cập vào nhiều loại LLM khác nhau từ các nhà cung cấp khác nhau, bao gồm cả Perplexity. Bạn trả tiền cho OpenRouter dựa trên mức sử dụng của bạn, và họ xử lý các cuộc gọi backend đến các nhà cung cấp mô hình tương ứng.

Bạn có thể kiểm tra API Perplexity AI có sẵn tại đây:

Các yêu cầu tiên quyết:

  • Một Tài khoản OpenRouter (openrouter.ai).
  • Quỹ đã thêm vào tài khoản OpenRouter của bạn hoặc thiết lập thanh toán.
  • Hiểu biết cơ bản về REST API.

Bước 1: Nhận Khóa API OpenRouter của Bạn

  1. Đăng ký/Đăng nhập: Truy cập openrouter.ai và tạo một tài khoản hoặc đăng nhập.
  2. Đi tới Khóa: Tìm phần 'Keys' hoặc 'API Keys' trong cài đặt tài khoản của bạn.
  3. Tạo Khóa: Tạo một khóa API mới.
  4. Sao chép và Bảo mật: Sao chép khóa được tạo ra và lưu trữ an toàn, giống như khóa Perplexity chính thức.

Bước 2: Xác định các Mô hình API Perplexity AI trên OpenRouter

OpenRouter sử dụng quy tắc đặt tên riêng của mình, thường thêm tiền tố là tên của nhà cung cấp. Các mô hình Perplexity trên OpenRouter có thể trông giống như:

  • perplexity/sonar-small-chat
  • perplexity/sonar-small-online
  • perplexity/sonar-medium-chat
  • perplexity/sonar-medium-online
  • (Kiểm tra trang /models của OpenRouter để có danh sách hiện tại và các tên chính xác)

Bước 3: Thực hiện Yêu cầu API qua Điểm cuối OpenRouter cho Các Mô hình API Perplexity AI

OpenRouter sử dụng một điểm cuối API tương thích với OpenAI:

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

Bạn cấu trúc yêu cầu của mình tương tự như API Perplexity chính thức hoặc API OpenAI, nhưng sử dụng khóa OpenRouter của bạn và tên mô hình OpenRouter.

Sử dụng 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" \\\\ # Tùy chọn, nhưng được OpenRouter khuyên dùng
  -H "X-Title: YOUR_APP_NAME" \\\\      # Tùy chọn, nhưng được OpenRouter khuyên dùng
  -d '{
    "model": "perplexity/sonar-medium-online",
    "messages": [
      {"role": "user", "content": "OpenRouter cung cấp quyền truy cập vào các mô hình API Perplexity AI như thế nào?"}
    ]
  }'

Lưu ý: OpenRouter khuyên bạn nên thêm các tiêu đề HTTP-RefererX-Title để xác định ứng dụng của bạn. Thay thế YOUR_OPENROUTER_API_KEY, YOUR_SITE_URL, và YOUR_APP_NAME cho phù hợp.

Bước 4: Xử lý Phản hồi OpenRouter cho Các Mô hình API Perplexity AI

Cấu trúc phản hồi từ OpenRouter thường giống hệt tiêu chuẩn OpenAI/Perplexity, bao gồm các trường choices, message, content, và usage. Sự khác biệt chính là chi phí được tính dựa trên giá cả của OpenRouter cho mô hình Perplexity mà bạn đã sử dụng.

Lợi ích khi sử dụng OpenRouter:

  • Truy cập vào các mô hình Perplexity mà không cần có đăng ký Perplexity Pro trực tiếp.
  • Thanh toán hợp nhất cho nhiều LLM từ các nhà cung cấp khác nhau.
  • Một khóa API và điểm cuối cho nhiều mô hình khác nhau.

Cân nhắc:

  • Giá cả có thể khác với chi phí API trực tiếp của Perplexity.
  • Có khả năng độ trễ cao hơn chút đỉnh do có thêm bước trung gian.
  • Phụ thuộc vào khả năng truy cập nền tảng của OpenRouter và việc tích hợp của họ với Perplexity.

Kết luận

Bài hướng dẫn này cung cấp một hướng dẫn chi tiết về việc truy cập vào các mô hình mạnh mẽ phía sau Perplexity AI thông qua nhiều phương pháp API khác nhau. Hãy nhớ luôn tham khảo tài liệu chính thức của Perplexity, OpenRouter để có tên mô hình, điểm cuối, giá cả và tính năng cập nhật nhất. Bảo mật các khóa API của bạn và chọn phương pháp truy cập phù hợp nhất với yêu cầu dự án và ngân sách của bạn.