判断 API

Jev APIコードがそのまま使える判断を。

コンテキストと型付きの質問を送信し、振り分け・評価・自動化に使える確率と構造化された回答を取得。プレイグラウンドで試してから、1 回の 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 キーで認証します。

3 種類の回答形式

1 つの API で Noul・Choice・Score に対応。

成功した呼び出しのみ課金

判断リクエスト 1 回につき 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 は「解約しにくい」から「解約しやすい」までの 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 は選択肢が近いかを示します。

わかりやすい導入情報

組み込む前に、仕様を確認。

明確な利用料金

成功した判断リクエストは 1 回 1 クレジット。入力検証エラーや失敗したリクエストでは消費しません。チャージ前にプランを確認できます。

料金を見る

ドキュメント付きのアクセス

ダッシュボードで API キーを作成。ドキュメントのリクエスト形式、レスポンス例、制限を確認して連携を設計できます。

API ドキュメントを読む

制限

このエンドポイントの 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 つでも 6 つでも 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 に沿って自分のキーで呼び出します。