判断 API

Jev API コードで型付き判断を

Jev は TypeSafe AI の System One モデルです。テキストではなく、確率つきの Noul、Choice、Score を返します。ここでキーを取得し、1 回の 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 は「解約しにくい」から「解約しやすい」までの 3 段階です。

{
  "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 は勝者に加え、定義した各選択肢の確率も返します。

1 回のリクエストで Noul、Choice、Score

最大 6 つの質問が一つの状態を共有し、1 回の応答で返ります。はい/いいえ、ラベル付き選択、スコアが、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 つでも 6 つでも 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 に沿って自分のキーで呼び出します。