퍼플렉시티 AI 활용법 API KEY 키발급 설정부터 호출까지

 

 

 

 

퍼플렉시티 AI 활용법 API KEY 키발급 설정부터 호출까지

퍼플렉시티 AI는 자연어 처리와 대규모 언어 모델(LLM)을 바탕으로 질문에 신뢰할 수 있는 근거와 출처를 함께 제공하는 혁신적인 검색 플랫폼입니다.

 

AI API KEY를 통해 애플리케이션, 자동화 스크립트, 데브옵스 파이프라인 등에 지능형 질문·응답 기능을 손쉽게 통합할 수 있습니다. 필자는 여러 AI모델을 구독하고 있어 퍼플렉시티 AI API 키 발급부터 파이썬, PowerShell 예제, 오류 처리, 보안 관리 방법까지 단계별로 상세히 설명해보겠습니다. 이 글을 통해 개발 생산성을 높이고, 효율적인 정보 탐색 워크플로우를 구축해 보시기 바랍니다.

퍼플렉스시티 API KEY 발급

퍼플렉시티 AI 개발자 포털에 접속해 회원가입을 완료하면 API 키를 발급받을 수 있습니다.

 

 

계정 > 계정 설정

 

API 키를 눌러서 "키 생성"을 하면 됩니다.

 

 

키는 애플리케이션 접근 권한을 관리하는 핵심 자격 증명이므로 안전하게 보관해야 합니다. 환경 변수 설정을 추천합니다. 예를 들어 Windows PowerShell에서는 다음 명령으로 키를 등록할 수 있습니다.

[Environment]::SetEnvironmentVariable('PPLX_API_KEY', '여기에_발급된_API_키', 'User')

이렇게 등록하면 코드 내에서 $env:PPLX_API_KEY로 참조할 수 있어 키 하드코딩을 방지합니다.

 

PowerShell을 통한 API 호출 예제

아래 예제는 PowerShell을 이용해 sonar 모델로 간단한 산수 질문을 전송하는 과정입니다.

인증 헤더 구성

$apiKey = $env:PPLX_API_KEY
$headers = @{
  Authorization = "Bearer $apiKey"
  'Content-Type' = 'application/json'
}

요청 바디 작성

$body = @{
  model = 'sonar'
  messages = @(
    @{ role = 'system'; content = 'You are a helpful assistant.' }
    @{ role = 'user';   content = '2+2는 얼마인가요?' }
  )
} | ConvertTo-Json -Depth 5

한줄 스크립트

# 1. API 키 설정 $apiKey = "API키"   # 2. 요청 헤더 $headers = @{     "Authorization" = "Bearer $apiKey"     "Content-Type"  = "application/json" }   # 3. 바디: 아주 단순한 산수 질문 $body = @{     model    = "sonar"     messages = @(         @{ role = "system"; content = "You are a helpful assistant." }         @{ role = "user";   content = "2+2는 얼마인가요?" }     ) } | ConvertTo-Json -Depth 5   # 4. 엔드포인트 $endpoint = "https://api.perplexity.ai/chat/completions"   # 5. 호출 try {     $response = Invoke-RestMethod -Uri $endpoint -Method Post -Headers $headers -Body $body     $response | ConvertTo-Json -Depth 10 } catch {     Write-Host "오류 발생:" $_.Exception.Response.StatusCode.Value__ $_.Exception.Response.StatusDescription }

 

API 엔드포인트 호출

$endpoint = 'https://api.perplexity.ai/chat/completions'
try {
  $response = Invoke-RestMethod -Uri $endpoint -Method Post -Headers $headers -Body $body
  $response | ConvertTo-Json -Depth 10
} catch {
  Write-Warning "API 호출 중 오류가 발생했습니다: $_"
}

성공적으로 호출되면 JSON 형식의 응답이 반환됩니다. choices[0].message.content 필드에 실제 답변이 포함됩니다.

응답 구조 분석

{     "id":  "7e7c3c01-5bbf-4748-878a-b8c54de62bf4",     "model":  "sonar",     "created":  1752220532,     "usage":  {                   "prompt_tokens":  13,                   "completion_tokens":  30,                   "total_tokens":  43,                   "search_context_size":  "low"               },     "citations":  [                       "https://www.twoplustwo.com",                       "https://www.youtube.com/watch?v=8vkap4GvyG4",                       "https://2plus2.net",                       "https://forumserver.twoplustwo.com",                       "https://en.wikipedia.org/wiki/2+2"                   ],     "search_results":  [                            {                                "title":  "TwoPlusTwo",                                "url":  "https://www.twoplustwo.com",                                "date":  "2024-01-01",                                "last_updated":  "2025-07-11"                            },                            {                                "title":  "2 + 2 = ? - YouTube",                                "url":  "https://www.youtube.com/watch?v=8vkap4GvyG4",                                "date":  "2019-12-05",                                "last_updated":  "2025-05-24"                            },                            {                                "title":  "2+2 Management",                                "url":  "https://2plus2.net",                                "date":  "2018-10-01",                                "last_updated":  "2025-03-17"                            },                            {                                "title":  "Two Plus Two Forums",                                "url":  "https://forumserver.twoplustwo.com",                                "date":  null,                                "last_updated":  "2024-12-10"                            },                            {                                "title":  "2+2 - Wikipedia",                                "url":  "https://en.wikipedia.org/wiki/2+2",                                "date":  null,                                "last_updated":  null                            }                        ],     "object":  "chat.completion",     "choices":  [                     {                         "index":  0,                         "finish_reason":  "stop",                         "message":  {                                         "role":  "assistant",                                         "content":  "The sum of **2 + 2 is 4**. This is the basic arithmetic addition result where adding two and two equals four[5]."                                     },                         "delta":  {                                       "role":  "assistant",                                       "content":  ""                                   }                     }                 ] }

응답은 주요 항목으로 구성됩니다.

• id: 요청 식별자
• model: 사용된 모델 이름
• created: 타임스탬프
• usage: 프롬프트·컴플리션 토큰 사용량
• citations: 근거 출처 목록
• search_results: 관련 자료 링크
• choices: 챗봇 응답 메시지

위 항목을 활용해 트래픽 모니터링이나 비용 최적화를 구현할 수 있습니다.

 

 

퍼플렉시티 AI의 사용량입니다. 테스트한게 바로 찍히네요. 기본 크레딧 5달러에서 차감되고 있습니다.

 

퍼플렉시티 AI KEY 실전 활용 사례

• 고객 문의 자동응답 챗봇 구축
• 주식·경제 지표 요약 리포트 자동 생성
• PR(풀 리퀘스트) 코드 리뷰 코멘트 자동 작성

각 사례에서 API 호출 자동화와 결과 파싱을 통해 업무 효율성을 크게 향상할 수 있습니다. 이번 가이드를 통해 퍼플렉시티 AI API를 활용하는 기본 과정을 익히셨습니다. 다음으로는 배치 호출 최적화, Redis 캐싱 전략 적용, Sonar API 심층 연동, 프롬프트 엔지니어링 고도화 등을 시도해 보시기 바랍니다.

 

퍼플렉시티 할인코드

https://ndolson.com/531591

IT 전문가를 위한 퍼플렉시티 AI 심층 사용법

위의 포스팅을 참고하여 공유계정으로 더 저렴하게 퍼플렉시티 AI를 구독할 수 있습니다.