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를 보세요.
usdUSD 문자열. 소액은 마이크로달러 자릿수까지 유지합니다.
microUsd남은 마이크로달러. 1 USD = 1,000,000.
inputTokensLeft100만 개당 $0.042인 입력 토큰 기준으로 이 잔액이 감당할 수 있는 입력 토큰 수.

오류

상태error
401unauthorized / invalid_api_keyAPI Key가 없거나 유효하지 않습니다.
400invalid_requeststate가 너무 짧거나 질문이 없습니다.
429quota_exceeded잔액 부족. retry-after가 포함됩니다.
502upstream_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 사용하기

문서

사례

이 사이트의 다른 입구