API
API
API Key로 자신의 프로그램에서 판정을 호출합니다. 가입 시 $$5.00 크레딧이 지급됩니다. jev-1.13.0과 같이 입력 토큰만, 100만 개당 $$0.042, 출력 무료입니다.
계정 페이지에서 Key를 발급합니다. 평문은 한 번만 표시되며 서버는 sha256만 보관합니다.
계정 페이지에서 Key 발급인증
모든 /v1/* 요청에는 Bearer Key가 필요합니다. Key만 인정하며 브라우저 세션 쿠키는 받지 않습니다. 웹 로그인 상태와 과금되는 호출을 분리합니다.
Authorization: Bearer jev_...엔드포인트
POST /v1/judge | 판정을 한 번 실행합니다. 이번 호출의 입력 토큰으로 과금되며 성공한 뒤에만 차감됩니다. 업스트림 실패는 과금되지 않습니다. |
GET /v1/me | 현재 사용자, 잔액, 누적 사용. |
GET /v1/usage | 잔액, 누적 사용, 최근 사용 내역. |
요청 본문(/v1/judge)
state | 판정할 텍스트, 8–4000자. |
questions | 최대 6문항. 키 이름은 소문자로 시작하는 식별자여야 합니다. |
질문 유형
noul | 관련도. 0–1 실수를 반환합니다. |
confidence | 신뢰도. 0–1 실수를 반환합니다. |
choice | 주어진 선택지에서 하나를 골라 선택된 문자열을 반환합니다. options 배열이나 criteria 객체를 보낼 수 있으며, 서버가 options를 criteria로 합쳐 모델에 전달합니다. |
응답
이번 호출 후 잔액.
{
"id": "k3f9a1c2b4d5",
"model": "clavue-jev",
"answers": {
"relevance": { "noul": 0.92 },
"confidence": { "noul": 0.78 },
"severity": { "choice": "medium" }
},
"credit": { "cents": 500, "usd": "5.00", "microUsd": 5000000, "inputTokensLeft": 119047619 }
}credit 구조
{
"cents": 500,
"usd": "5.00",
"microUsd": 5000000,
"inputTokensLeft": 119047619
}cents | 잔액을 센트 단위로 반올림한 값. 정확한 잔액은 usd와 microUsd를 보세요. |
usd | USD 문자열. 소액은 마이크로달러 자릿수까지 유지합니다. |
microUsd | 남은 마이크로달러. 1 USD = 1,000,000. |
inputTokensLeft | 100만 개당 $0.042인 입력 토큰 기준으로 이 잔액이 감당할 수 있는 입력 토큰 수. |
오류
| 상태 | error | |
|---|---|---|
401 | unauthorized / invalid_api_key | API Key가 없거나 유효하지 않습니다. |
400 | invalid_request | state가 너무 짧거나 질문이 없습니다. |
429 | quota_exceeded | 잔액 부족. retry-after가 포함됩니다. |
502 | upstream_unavailable | 판정 백엔드를 일시적으로 사용할 수 없습니다. 이번 호출은 과금되지 않습니다. |
예시
curl https://api.jevcode.ai/v1/judge \
-H "Authorization: Bearer jev_..." \
-H "Content-Type: application/json" \
-d '{
"state": "The build failed on the second job, then passed after a retry.",
"questions": {
"relevance": { "type": "noul", "instructions": "Is this about CI?" },
"confidence": { "type": "confidence", "instructions": "How sure are you?" },
"severity": { "type": "choice", "instructions": "Pick one.",
"options": ["low", "medium", "high"] }
}
}'이어서 볼 페이지
체험, 문서, 사례, 가격이 서로 이어집니다. 이 페이지에서 바로 다음 페이지로 갈 수 있습니다.
clavue-jev 사용하기
문서
- 소개이 모델이 무엇을 푸는지.
- 빠른 시작한 번의 호출로 실행되는 최소 예시.
- System One이 사이트가 쓴 개념: 상태에 타입이 있는 질문 하나. 모델은 clavue-jev.
- 상태판정에 보내는 텍스트.
- 신뢰도반환의 확실성. 자동 실행 여부를 정할 때 씁니다.
- Choice상호 배타적인 선택지에서 하나를 고름.
- Noul예/아니오 질문으로, '예'의 확률로 반환됩니다.
- Score척도를 따라 점수를 매김.
- 의도 라우팅Choice 한 번으로 요청을 하위로 보냅니다.
- 신뢰도 라우팅신뢰도가 높으면 자동 실행, 낮으면 사람에게.
- 팬아웃하나의 상태에 여러 질문을 동시에.
- 복합 스코어링여러 점수를 하나의 순위로 합칩니다.
- HTTP APISDK 없이 쓰는 요청 형태.
- Python SDKPython에서 판정을 호출합니다.
- JavaScript SDKJavaScript에서 판정을 호출합니다.