Perplexity API, VS Code에서 갑자기 401 오류? (월 크레딧/키/결제/키 관리)

VS Code에서 Perplexity API 연동 프로젝트를 잘 쓰고 있다가 어느 날 갑자기 401 Unauthorized 에러가 떴다. 분명 어제까지 문제없었고, API 키와 코드도 손댄 게 없는데 갑자기 막혀버린 것.

원인부터 정리

1. 크레딧 소진

프로 계정은 매월 1일 $5 API 크레딧이 자동 지급된다.
이걸 다 쓰면, 잔여 크레딧이 충전될 때까지 API가 무조건 401 에러.
(추가 크레딧 결제 시 바로 사용 재개)

2. 키 관리 정책—최대 2개만 발급

Perplexity는 API 키를 동시에 두 개까지만 생성할 수 있다.

• 둘 다 발급 상태라면, 새 키를 만들고 싶으면 기존 키 중 하나를 삭제해야 한다.
• 키를 다 삭제해도 다시 두 개까지 발급 가능.
• 실서비스와 개발/테스트용 키를 나눠 쓰거나, 주기적 보안 교체 등으로 이 점을 유의해야 한다.

3. 키 바꿀 필요 없음

크레딧이 새로 충전돼도 기존 키를 계속 써도 된다. (직접 키를 삭제/교체하지 않는 이상)
API 키는 월마다 따로 바꿔줄 필요가 없다.

4. 실제 점검 방법

1. Perplexity 대시보드에서 크레딧 잔액 확인
2. 크레딧이 0 → 결제하거나 다음 달 1일까지 대기
3. 키·설정 문제 없는데 401 → 네트워크, 환경변수, 헤더 누락 등도 의심
4. 키 추가 발급이 안 된다면, 기존 2개 중 하나 삭제 후 새로 발급

실전 예시: cURL로 점검

아래처럼 cURL로 간단히 체크해서도 막히면 거의 크레딧/키/결제 문제다.

curl --location 'https://api.perplexity.ai/chat/completions' \
  --header 'Authorization: Bearer <PERPLEXITY_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sonar-pro",
    "messages": [{"role":"user","content":"ping"}]
  }'

---

한 줄 요약

설정 이상 없는데 401?
→ 크레딧 소진 or 키 관리 정책(최대 2개), 잔액/키 확인부터!
→ 바로 계속 쓰려면 크레딧 충전, 키 관리도 깔끔하게.