API 개요

모든 엔드포인트는 https://router.pleum.ai/v1 아래에 있으며, OpenAI API와 호환됩니다.

Base URL

base url

https://router.pleum.ai/v1

OpenAI SDK를 사용하는 경우 base_url(Python) 또는 baseURL(JS)에 위 주소를 넣으면 됩니다.

모든 추론 요청은 Authorization 헤더에 API 키를 담아 보냅니다. API 키는 대시보드 → API 키에서 발급하며 plm_ 접두사로 시작합니다.

header

Authorization: Bearer plm_xxxxxxxxxxxxxxxx

API 키는 발급 시 한 번만 표시되며 서버에는 해시만 저장됩니다. 키가 유출되면 대시보드에서 즉시 비활성화하세요. 키별로 허용 모델, 허용 데이터 티어, 월 예산 한도를 제한할 수 있습니다.

POST/v1/chat/completions

채팅 완성을 생성합니다. 레퍼런스 →

GET/v1/models

사용 가능한 모델 목록과 가격을 조회합니다. 레퍼런스 →

GET/v1/credits

크레딧 잔액을 조회합니다. 레퍼런스 →

GET/v1/fx-rate

오늘 적용 중인 USD/KRW 환율을 조회합니다 (한국수출입은행 기준 + 마진 3%). 인증 불필요.

에러는 HTTP 상태 코드와 함께 detail 필드로 반환됩니다. 구조화된 에러(크레딧 부족, PIPA 동의 필요)는 error 코드 문자열을 포함합니다.

402 Payment Required

{
  "detail": {
    "error": "insufficient_credits",
    "message": "사용 가능 크레딧 부족: ₩120 < ₩540"
  }
}

전체 에러 코드 목록은 에러 코드 문서를 참고하세요.