Perplexity API 빠른 시작

Perplexity API 빠른 시작 (Quickstart)

Perplexity API를 처음 쓰는 분들을 위한 가장 짧은 입문 경로예요. API 키를 하나 발급받아 환경 변수에 넣고 나면, 사전 설정(preset)이나 특정 모델로 첫 호출을 해볼 수 있어요. 전체 과정이 수 분 안에 끝나요.

출처: Perplexity API Quickstart

API 키 생성

API 콘솔의 API Keys 페이지에서 새 키를 만듭니다. 발급된 키는 PERPLEXITY_API_KEY 환경 변수로 설정해 두면, 공식 SDK가 자동으로 읽어요. 라이브러리 초기화 코드에서 키를 직접 넣지 않아도 되는 편리한 방식이에요.

개요 — 네 가지 API

Perplexity API는 용도별로 네 가지가 나뉘어요. OpenAI·Anthropic 호환 엔드포인트를 통해 오픈웨이트 모델에 직접 접근하는 Router, OpenAI·Anthropic·Google·xAI 모델에 통합 웹 검색 툴과 투명한 요금제를 얹은 Agent API, 실시간 웹 검색 결과를 돌려주는 Search, 임베딩 생성용 Embeddings가 그것이에요. 각자의 목적에 맞는 API를 고르면 돼요.

첫 번째 API 호출

첫 호출을 어떤 방식으로 하든 흐름은 비슷해요. Router 카탈로그의 아무 모델이나 골라 호출하거나, preset을 사용해 바로 응답을 받을 수 있어요. 예를 들어 Python SDK로 preset을 쓰면 이렇게 간단해져요.

from perplexity import Perplexity

# PERPLEXITY_API_KEY 환경 변수를 사용해 초기화
client = Perplexity()

response = client.responses.create(
    preset="low",
    input="정상회담이 NLP를 바꾼 이유는 무엇인가요?"
)
print(response.output_text)

cURL로도 같은 요청을 보낼 수 있어요. POST https://api.perplexity.ai/v1/agent로 Authorization: Bearer $PERPLEXITY_API_KEY 헤더를 붙이면 됩니다.

스트리밍 응답

대화형 느낌이 필요한 곳에선 스트리밍이 유용해요. stream=True를 붙이면 토큰이 도착하는 대로 응답을 받을 수 있어요. 스트리밍의 파싱·오류 처리·인용 관리까지 자세히 알고 싶다면 전용 가이드를 참고하세요.

다음 단계

더 알아보기