소개
state에 근거를 제공하고 noul, choice, score로 questions를 정의합니다. 각 질문은 해당 state를 독립적으로 평가하며 작업 결과는 지정한 이름 아래에 반환됩니다. 전체 요청은 64k토큰, state와 각 질문의 합계는 32k토큰 이내로 구성합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 정형 데이터 |
| 개발사와 모델 | TypeSafe — Jev 1.14 (jev-1.14.0) |
| 출시일 | 2026년 10월 14일; 이전 빌드는 Jev 1.13 |
| 공개 API 이름 | typesafe/jev-1.14/decision |
| state 입력 | 문자열, JSON 객체 또는 JSON 배열 |
| 질문 유형 | noul, choice, score |
| 호출당 질문 수 | 최대 64개, 독립적으로 병렬 처리 |
| 컨텍스트 제한 | 요청당 64k토큰; state와 개별 질문의 합계는 32k토큰 |
| choice 선택지 | 설명이 있는 명명된 선택지 1–255개 |
| score 평가 기준 | 낮은 순서부터 높은 순서로 정렬한 2–10단계 |
| 작업 출력 | output.decision에 answers와 inputTokens 포함 |
| 관측 지연 시간 | 자체 호출은 약 0.6초; 이전 탐색 호출은 0.62초 |
| 과금 단위 | 실측 입력 토큰; 출력 토큰은 무료 |
핵심 기능 및 하이라이트
확률, 범주, 평가 점수
코드에서 필요한 값에 맞춰 3가지 질문 유형을 고릅니다. noul은 0–1의 긍정 확률을, choice는 명명된 선택지와 confidence 및 선택지별 확률을 반환합니다. score는 확률로 가중한 단계 값과 confidence, legend, 단계별 확률을 제공합니다.
공통 state에서 독립적으로 판단합니다
최대 64개 질문이 같은 state를 독립적으로 병렬 평가하며, 질문을 늘려도 지연 시간의 변화는 작습니다. 지원 요청의 담당 팀, 긴급성, 환불 의도를 함께 묻고 애플리케이션 로직에서 결과를 조합합니다.
답변과 불확실성을 함께 살펴봅니다
자체 숏폼 영상 검토에서 근거 점수는 1.44, confidence는 0.28이었고 제안이 있다는 확률은 0.98이었습니다. 서로 다른 판단을 나타내는 값이므로 제안이 명확하다고 해서 제품 주장에 대한 근거도 똑같이 명확한 것은 아닙니다.
검토 전환 기준을 코드로 정합니다
담당자나 생성형 모델로 항목을 보낼 확률 및 confidence 임계값을 정의합니다. Jev 1.14는 서술형 근거 없이 구조화된 판단을 제공하므로, 불확실한 답변이 후속 조치에 영향을 준다면 원본 근거를 검토합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
questions | 예 | 최대 64개 질문에 이름을 붙이고 type과 instructions를 지정합니다. criteria에는 choice 선택지 1–255개 또는 낮은 순서부터 높은 순서의 score 2–10단계를 정의하며, noul에는 true/false 설명을 선택적으로 넣습니다. |
state | 예 | 각 판단에 필요한 근거를 문자열, JSON 객체 또는 배열로 제공합니다. 질문은 다른 질문의 답변에 의존할 수 없습니다. 1자 이상 |
요금
$0.0000504 / 1,000 토큰
실측 입력 토큰에 과금하며 출력 토큰은 무료입니다. 접수 시 64k토큰 요청 한도를 기준으로 금액을 보류하고 정산 시 차액을 해제합니다.
활용 사례
숏폼 광고 문구를 검토합니다
제품 영상의 녹취록, 화면 문구, 프레임 설명을 state로 제공하고 도입 방식, 입증 근거, 제안 여부를 묻습니다. 표시된 자체 예제는 도입 유형 problem, 근거 점수 1.44, 제안 확률 0.98을 반환했으며 입력 토큰 537개를 사용했습니다.
결제 지원 요청을 분류합니다
‘해지 후에도 결제됐습니다. 갱신 요금을 환불해 주세요’ 같은 메시지와 관련 계정 정보를 보냅니다. 담당 팀, 긴급성, 환불 의도를 요청한 자체 지원 예제는 입력 토큰 422개로 billing, 긴급성 1.6, refund_requested 0.96을 반환했습니다.
리뷰 감정과 재구매 의도를 구분합니다
‘마감이 벗겨졌지만 고쳐지면 다시 주문하겠습니다’ 같은 리뷰에 감정, 문제점, 재구매 의도를 각각 묻습니다. 자체 리뷰 예제는 입력 토큰 435개를 사용해 sentiment 1.45, 문제 유형 quality, would_return 0.97을 반환했습니다.
게시 전 상품 정보를 확인합니다
상품명, 설명, 필수 항목을 보내 제목이 설명과 일치하는지, 필요한 정보가 있는지 묻습니다. 예·아니요 확률을 게시 조건으로 활용하고 모호한 상품 정보는 담당자 검토를 위해 보류합니다.
후속 검토 전 잠재 고객을 평가합니다
‘다음 달에 팀 전체 도입이 필요합니다’ 같은 문의와 제공된 회사 및 일정 항목을 전달합니다. 순서가 있는 적합성 단계를 정의하고 누락된 정보도 질문한 뒤, 점수와 불확실성으로 생성형 후속 응대가 필요한 고객을 판단합니다.
프롬프트 가이드 및 실전 팁
공통 근거를 준비합니다
지원 요청, 녹취록, 리뷰를 문자열이나 JSON 객체 또는 배열로 state에 넣습니다. 질문끼리 서로의 답변을 읽을 수 없으므로 각 질문에 필요한 근거를 모두 포함합니다.
유형이 지정된 질문을 정의합니다
질문마다 이름, 유형, instructions를 지정하고 criteria에 choice 선택지나 순서가 있는 score 단계를 설명합니다. 예·아니요 확률은 noul, 범주는 choice, 평가 점수는 score를 선택합니다.
판단 엔드포인트를 호출합니다
POST /api/v1/jobs/createTask?wait=30에 model을 typesafe/jev-1.14/decision으로 지정하고 input에 state와 questions를 넣습니다. 완료된 작업의 output.decision을 읽거나 작업 생성 후 recordInfo를 폴링합니다.
답변을 검증하고 분기합니다
임계값을 정하기 전에 자체 표본의 사람 라벨과 확률 및 confidence를 비교합니다. 불확실한 사례를 검토로 보내고 판단 결과와 함께 inputTokens를 기록합니다.
형식화된 판단을 위한 Jev 1.14 API
Jev 1.14는 텍스트나 JSON을 분류하고 평가하는 TypeSafe의 System One 판단 모델입니다. 이 엔드포인트는 서술형 문장이나 추론 설명을 생성하지 않고 예·아니요 확률, 명명된 선택 항목, 평가 점수를 반환합니다. 답변을 지원 요청 라우팅, 리뷰 검사, 후속 검토에 적용합니다.
판단 요청 보내기
공개 모델 이름 typesafe/jev-1.14/decision으로 POST /api/v1/jobs/createTask?wait=30을 호출합니다. 아래 결제 요청은 설명용이며 자체 실측 예제와는 별개입니다.
{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": {
"message": "I cancelled before renewal but was charged again. Please refund it today."
},
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this message?",
"criteria": {
"billing": "Charges, renewals and refunds",
"technical": "Product errors and access problems"
}
},
"urgency": {
"type": "score",
"instructions": "How urgently does this message request action?",
"criteria": ["No time pressure", "Action requested soon", "Immediate action requested"]
},
"refund_requested": {
"type": "noul",
"instructions": "The customer is asking for money back",
"criteria": {
"true": "A refund or repayment is requested",
"false": "No refund or repayment is requested"
}
}
}
}
}
작업 출력 읽기
완료 결과에는 output.decision.answers와 output.decision.inputTokens가 제공됩니다. 작업을 만든 뒤 recordInfo를 폴링할 수도 있습니다. 다음 발췌문은 자체 지원 분류 실측 응답의 일부 필드를 보여 줍니다.
{
"output": {
"decision": {
"answers": {
"team": {"choice": "billing", "confidence": 1.0},
"urgency": {"score": 1.6, "confidence": 0.4},
"refund_requested": {"noul": 0.96}
},
"inputTokens": 422
}
}
}
매개변수와 답변 유형
state는 최대 64개 질문이 독립적으로 병렬 평가할 공통 근거를 제공합니다.
| 필드 | 허용 값 | 활용 방법 |
|---|---|---|
state | 문자열, JSON 객체 또는 배열 | 근거 필드에 이름을 붙입니다 |
questions | 호출자가 고른 이름을 키로 사용하는 객체 | 답변을 검사 항목과 연결합니다 |
type | noul, choice, score | 긍정 확률, 범주, 순서가 있는 점수를 고릅니다 |
instructions | 질문 지시문 | 한 가지 판단에 집중해 질문합니다 |
noul의 criteria | 선택 사항인 true / false 설명 | 표현이 모호할 때 두 해석을 정의합니다 |
choice의 criteria | 이름과 설명이 있는 선택지 1–255개 | 범주의 경계를 정합니다 |
score의 criteria | 순서가 있는 2–10단계 설명 | 평가 기준을 낮은 순서부터 높은 순서로 배열합니다 |
noul 답변은 0–1의 긍정 확률입니다. choice는 choice, confidence, 선택지별 probabilities를 반환합니다. score는 확률로 가중한 score, confidence, 단계와 설명을 연결하는 legend, 단계별 probabilities를 반환합니다. 소수점 점수가 나올 수 있으므로 범주 라벨이 아니라 정의한 평가 기준에 비추어 읽습니다.
판단 기준 다듬기
근거와 기준을 명확히 하면 유용한 라우팅 규칙을 정하는 데 도움이 됩니다.
- 판단에 필요한 모든 사실을 state에 넣습니다. 다른 질문의 답변은 참조할 수 없습니다.
- 설명 없는 라벨 대신 구체적인 문구로 범주 경계와 점수 단계를 설명합니다.
- 환불 의도와 긴급성처럼 별개의 요소는 따로 질문한 뒤 코드에서 결합합니다.
- 라벨이 있는 표본을 반환 확률 및 confidence와 비교하고 불일치를 바탕으로 검토 임계값을 고릅니다.
낮은 confidence는 불확실성을 뜻하므로 담당자나 생성형 모델에 넘깁니다. noul에는 별도의 confidence 필드가 없습니다.
자체 예제에서 확인한 내용
자체 호출은 약 0.6초에 응답했고, 이전 질문 3개 탐색 호출은 입력 토큰 425개로 0.62초를 기록했습니다. TypeSafe는 출시 발표에서 종단 간 지연 시간을 70–500ms로 설명합니다. 이 개발사 발표 수치와 자체 관측치는 구분합니다.
| 예제 | 주요 결과 | 입력 토큰 |
|---|---|---|
| 숏폼 영상 검토 | hook: problem, confidence 1.0; proof: 1.44, confidence 0.28; has_offer: 0.98 | 537 |
| 지원 요청 분류 | team: billing, confidence 1.0; urgency: 1.6, confidence 0.4; refund_requested: 0.96 | 422 |
| 리뷰 검사 | sentiment: 1.45, confidence 0.32; issue: quality, confidence 1.0; would_return: 0.97 | 435 |
확신도가 높은 범주와 불확실한 점수가 함께 나올 수 있습니다. 이 예제만으로 자체 데이터셋에서의 정확성이 입증되지는 않습니다.
가격과 사용량
실측 입력 토큰을 기준으로 과금하며 출력 토큰은 무료입니다. 표시된 가격을 확인하고 inputTokens를 추적합니다. 접수 시 보류액은 요청 한도인 64k토큰을 기준으로 하며 작업 정산 때 차액을 해제합니다.
제한과 문제 해결
이 엔드포인트는 최대 질문 64개, 전체 요청 64k토큰, state와 단일 질문의 합계 32k토큰을 허용합니다. 컨텍스트를 초과하면 state나 criteria를 줄입니다. 질문 수만 줄여도 개별 질문의 한도 초과가 남을 수 있습니다.
텍스트와 JSON을 지원하며 이미지·영상·오디오 파일 및 box 질문은 사용할 수 없습니다. 영상은 녹취록, 화면 문구, 프레임 설명으로 표현합니다. 요청이 거절되면 재제출 전에 질문 유형, criteria 구조, 선택지 수, 두 컨텍스트 한도를 확인합니다. 판단이 틀렸다면 근거와 기준을 다시 검토합니다.
Jev와 대안 선택
유형이 정해진 판단에는 Jev를, 서술형 문장에는 생성형 모델을 선택합니다.
| 선택지 | 적합한 경우 |
|---|---|
| Jev 1.14 | 확률, 범주, 평가 점수 |
| Jev 1.13 | 이전 빌드이며 여기서는 두 빌드의 실측 비교를 제공하지 않습니다 |
| 생성형 모델 | 서술형 설명이나 답변 |
| 사람의 검토 | 모호한 근거나 불확실한 판단 |
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": "example",
"questions": {
"example": {
"type": "noul",
"instructions": "The customer asks for a refund after being billed twice."
}
}
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
