원문: Perplexity Docs · 수집일: 2026-10-02
핵심 요지
Perplexity가 오픈 가중치로 낸 pplx-decider-v1-27b를 호스팅 API로 제공하는 Decisions API의 퀵스타트다. 텍스트 대신 확률을 돌려주는 방식이고, TypeSafe Jev와 요청 구조(state + 이름 붙인 questions)가 거의 같다. 다만 엔드포인트는 Jev 호환 서버들이 쓰는 /v1/systemone이 아니라 자체 경로 /v1/decisions다. 문서는 이 모델을 “답을 쓰지도, 코드를 생성하지도, 추론을 설명하지도 않는 결정 모델”로 정의하고, 숫자를 받아 코드가 판단하라는 설계를 전제한다.
질문 3유형
| 유형 | 입력 | 응답 |
|---|---|---|
noul | 예/아니오 질문 또는 검증할 진술. instructions·criteria 중 하나 이상 필수(둘 다 없으면 400) | 예일 확률 0~1 |
choice | 선택지별 설명을 담은 criteria 맵(1~255개, 설명은 null 가능) | 선택지별 확률, 최상위 choice, confidence |
score | 순서 있는 criteria 배열(최대 10단계, 인덱스가 점수) | 확률가중 평균 score, legend, 단계별 확률, confidence |
confidence는 최상위 확률이 아니라 모델 자체의 확신 추정치다. 예시에서sentiment최상위 확률은 0.95, confidence는 0.93이고, 차점 후보가 가까우면 낮아진다.- 같은 요청은 대개 같은 숫자를 주지만 소수 둘째 자리가 흔들릴 수 있어, 임계값에는 여유를 두라고 권고한다.
- 한 요청에 질문을 1~128개 던질 수 있다. 같은
state에 대한 여러 판단을 한 번에 처리한다.
호출
POST https://api.perplexity.ai/v1/decisions, 헤더 Authorization: Bearer <PERPLEXITY_API_KEY>(x-api-key는 401), 모델명은 pplx-decider-v1-27b를 매 요청에 명시한다.
{"model": "pplx-decider-v1-27b",
"state": {"title": "Battery died after two weeks", "review": "..."},
"questions": {
"defect": {"type": "noul", "instructions": "Does the review report a product defect?"},
"severity": {"type": "score", "instructions": "How severe is the reported problem?",
"criteria": ["Cosmetic", "Inconvenient", "Product unusable"]}}}문서 예시(헤드폰 리뷰)의 응답은 결함 여부 0.94, 감성 mixed(0.95), 심각도 1.78(0~2 척도)이며 usage는 입력 367토큰·출력 3토큰이다.
이미지 입력
state를 배열로 두고 OpenAI 스타일image_url파트에 base64 data URL을 넣는다. PNG·JPEG·WebP만 허용하고http(s)URL은 400이다(API가 URL을 가져오지 않음).- 32×32 픽셀 타일 기준으로 이미지당 2,048타일 이하여야 한다(1440×1440, 2048×1024 가능, 1600×1310 불가). 초과해도 400이 아니라 약 1분 대기 후 504가 나므로 미리 리사이즈해야 한다. 이미지는 메가픽셀당 입력 약 1,000토큰이다.
한도·성능·가격
| 항목 | 값 |
|---|---|
| 입력 토큰 | 요청당 262,144 미만 |
| 요청 본문 | 32 MiB |
| 레이트 리밋 | 조직당 초당 10요청(전 플랜), 대량 버스트엔 토큰 한도, 초과 시 429 + Retry-After |
| 지연 | 수백 토큰 2초 미만, 약 9만 토큰 5초, 약 19만 토큰 14초, 한도 직전 23초(2026-09-30 자체 측정) |
| 가격 | 입력 $0.04/백만 토큰, 출력 무료, 요청당 요금 없음 |
오류는 400(필드·한도 위반)·401·404(슬래시 포함 다른 경로)·405·413·429·5xx로 나뉘고, 응답 본문은 error.message와 error.type으로 읽고 error.code로 분기하지 말라고 한다. 성공·대부분의 오류 응답에 x-request-id가 붙는다.
의미와 한계
- 오픈 가중치 모델 카드와 짝을 이룬다. 자체 GPU(약 49GiB)로 돌리려면 가중치를, 호스팅으로 쓰려면 이 API를 쓴다. 모델 카드는
choice·noul만 예시로 들지만 API는score까지 받는다. - 가격·한도·지연 수치는 모두 원문의 자체 측정·정책 값이며 독립 검증은 없다. 가격은 바뀔 수 있다.
- 다음 단계로 API 레퍼런스와 티켓 분류 쿡북(티켓 12건을 질문 3개로 라우팅하고 에스컬레이션만 Agent API로 보냄)이 안내된다.
연결
- jev · moc-jev: 원조 Jev와 결정 모델 생태계 지도
- 2026-09-30-ollama-jev-style-decision-models: 같은 질문 3유형을 로컬에서
/v1/systemone으로 처리하는 Ollama 0.35(추가 비용 없음) - 2026-10-04-github-realzachi-pg-jev: Jev를 Postgres 함수로 감싼 확장. 스킬 문서가 안내하는 Jev 단가는 입력 100만 토큰당 $0.042로, 이 API와 비슷한 수준이다