결정 API

Jev API 코드에서 타입 결정을 위해

Jev는 TypeSafe AI의 System One 모델입니다. 텍스트 대신 확률이 붙은 Noul, Choice, Score를 반환합니다. 여기서 키를 받아 POST 한 번으로 호출하세요. 대기 명단은 없습니다.

{
  "model": "jev-1.13",
  "state": "I was charged twice for my subscription.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}

신규 계정 2회 무료 호출 · 성공 호출당 크레딧 1개 · 실패 호출은 무료

예시

바로 실행할 수 있는 결정 8개

카드에 올리면 요청이 보입니다. 복사하거나 플레이그라운드에서 여세요.

빈 결제 화면의 담당

Choice는 담당 팀과 각 팀의 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
플레이그라운드에서 열기

환불 요청인가

Noul은 파싱할 문장이 아니라 예 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
플레이그라운드에서 열기

지급 실패의 긴급도

Score는 정의한 척도 위의 위치와 분포를 반환합니다.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
플레이그라운드에서 열기

메시지 속 자격 증명 요구

Noul 확률은 사람 검토 큐 앞의 관문입니다.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
플레이그라운드에서 열기

인바운드 메모 자격

Choice는 구매 시점과 관심만 있는 메모를 나눕니다.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
플레이그라운드에서 열기

수익 보장 문구

Noul은 적은 정책 질문에 답하고, 일반적인 안전 문장을 쓰지 않습니다.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
플레이그라운드에서 열기

갱신 메모의 이탈 위험

Score는 이탈 가능성이 낮은 단계에서 높은 단계까지 세 칸을 씁니다.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
플레이그라운드에서 열기

어떤 송장 예외인가

Choice는 발주 초과, 예상 밖 항목, 또는 둘 다와 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
플레이그라운드에서 열기

응답

코드가 분기할 수 있는 답

Jev는 파싱할 문단을 쓰지 않습니다. 요청한 결정과 그 확률을 반환합니다.

모든 선택지에 확률이 남음

Choice는 승자와 함께 정의한 각 선택지의 확률을 반환합니다.

한 요청의 Noul, Choice, Score

최대 6개의 질문이 하나의 상태를 공유하고 한 응답으로 돌아옵니다. 예/아니오, 라벨 선택, 점수가 왕복 1회와 크레딧 1개면 됩니다.

임계값이 중요하면 모델을 고정

컷오프를 맞출 때는 jev-1.13을 보내세요. jev-latest는 이 API가 현재 제공하는 버전입니다.

사용 방법

Jev API 호출 방법

  1. 01

    키 만들기

    로그인한 뒤 대시보드에서 키를 복사하세요. 플레이그라운드가 계정용 키를 만들 수 있습니다.

  2. 02

    상태와 질문을 POST

    본문에는 model, state, 질문 맵이 있습니다. id는 라벨이고 질문 문장은 instructions에 둡니다.

  3. 03

    타입 답으로 분기

    noul, choice, score를 읽으세요. Choice와 Score의 confidence는 선택지가 가까운지 알려 줍니다.

제한

이 엔드포인트의 Jev API 제한

POST /api/v1/decisions가 현재 받아들이는 범위.

항목이 엔드포인트
엔드포인트POST /api/v1/decisions, Bearer 키
모델jev-1.13(jev-latest는 별칭)
호출당 질문 수1~6
Choice 선택지 수2~8
Score 단계 수2~10, 낮은 단계 먼저
State문자열, JSON 객체 또는 배열, 최대 60,000자
과금성공 호출당 크레딧 1개, 실패 호출은 무료
스트리밍지원 안 함

TypeSafe의 자체 API는 POST https://api.typesafe.ai/v1/systemone입니다. jev-1.13.0 같은 버전 id를 받고, Choice 선택지는 최대 255개이며, 입력 토큰당 과금합니다.

전체 레퍼런스는 Jev Docs

Jev API FAQ

Jev API란?

Jev API는 소프트웨어가 TypeSafe AI의 System One 모델인 Jev를 호출하는 방법입니다. 상태와 타입 질문을 보내면 Jev는 Noul 확률, 각 선택지의 확률이 있는 Choice, 또는 당신의 척도 위의 Score를 반환합니다. 텍스트는 쓰지 않습니다.

Jev API 키는 어떻게 받나요?

로그인하고 대시보드에서 키를 만드세요. 플레이그라운드가 첫 실행 때 만들 수 있습니다. 신규 계정은 크레딧 2개를 받고, 성공 호출 2회를 커버합니다. 대기 명단은 없습니다.

Jev API 호출 비용은?

성공한 POST /api/v1/decisions는 질문이 하나든 여섯이든 크레딧 1개를 씁니다. 검증 오류와 업스트림 실패는 쓰지 않습니다. 크레딧 약 100개가 세전 1 USD입니다. 요금제는 가격 페이지에 있습니다.

이것이 TypeSafe 공식 API인가요?

아니요. Jev는 TypeSafe AI가 만들고 제공합니다. 이 사이트는 독립 API 서비스로, 키·크레딧·지원은 TypeSafe 계정이 아니라 이 사이트에서 나옵니다. TypeSafe 콘솔과 토큰당 가격은 typesafe.ai를 참조하세요.

이 엔드포인트는 api.typesafe.ai/v1/systemone과 어떻게 다릅니까?

본문 형태는 같습니다. model, state, noul·choice·score 타입의 questions입니다. 여기서는 경로가 /api/v1/decisions이고, 키는 이 사이트 대시보드에서 나오며, 모델 id는 jev-1.13 또는 jev-latest입니다. 제한은 더 타이트합니다. 질문 1~6개, Choice 선택지 2~8개, Score 단계 2~10개.

Noul, Choice, Score의 차이는?

Noul은 확률이 있는 예/아니오입니다. Choice는 적은 선택지 중 하나를 고르고 각 확률을 반환합니다. Score는 낮은 순서의 척도에 놓습니다.

첫 결정을 보내기

예시 하나로 플레이그라운드를 열거나, Jev Docs를 따라 자신의 키로 호출하세요.