결정 API

Jev API코드가 바로 활용하는 의사결정.

맥락과 유형이 지정된 질문을 보내세요. 분류, 평가, 자동화에 필요한 확률과 구조화된 답변을 받습니다. 플레이그라운드에서 확인한 후 API 요청 한 번으로 연동하세요.

성공 호출당 크레딧 1개 · 실패 호출은 무료

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

요청 예제 · Bearer API 키로 인증합니다.

세 가지 답변 유형

하나의 API에서 Noul, Choice, Score를 지원합니다.

성공한 호출만 과금

의사결정 요청당 1 크레딧.

기존 기술 스택과 연동

HTTP 요청과 TypeSafe SDK를 지원합니다.

예시

바로 실행할 수 있는 결정 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는 선택지가 가까운지 알려 줍니다.

명확한 연동 정보

연동 전에 세부 사항을 확인하세요.

투명한 사용 요금

성공한 의사결정 요청당 1 크레딧이 차감됩니다. 유효성 검사 오류와 실패한 요청은 차감되지 않습니다. 충전 전에 요금제를 확인하세요.

요금 확인

문서화된 접근 방식

대시보드에서 API 키를 만드세요. 문서의 요청 형식, 응답 예제와 제한 사항을 참고해 연동을 계획할 수 있습니다.

API 문서 읽기

지원팀에 직접 문의

API 접근, 연동 또는 결제 관련 문의는 [email protected]로 보내세요. 문의 페이지에서 지원 정보를 확인할 수 있습니다.

지원팀 문의

제한

이 엔드포인트의 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 키는 어떻게 받나요?

로그인하고 대시보드에서 키를 만드세요. 플레이그라운드가 첫 실행 때 만들 수 있고, 첫 키는 바로 사용할 수 있습니다.

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과 어떻게 다릅니까?

jev-api.org는 이제 둘 다 제공합니다. POST /v1/systemone은 TypeSafe 본문(model, state, questions)을 그대로 받고 base URL만 바꾸면 TypeSafe SDK와 함께 동작합니다. POST /api/v1/decisions은 더 간단한 엔드포인트로 제한이 타이트합니다. 질문 1~6개, Choice 선택지 2~8개, Score 단계 2~10개. 키는 둘 다 이 사이트 대시보드에서 발급됩니다.

Noul, Choice, Score의 차이는?

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

첫 결정을 보내기

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