開発者向け / JevModel

JevModel API:リクエストと応答

JevModel API キーで Choice・Score・Noul を送信する手順。リクエスト制限、応答、エラーと課金を確認し、サーバーから最初の呼び出しを行いましょう。

最終更新:

要点

  • このガイドは JevModel の /api/v1/systemone、サイトの認証、制限、使用量を説明します。Jev 風の質問を扱う全提供元に共通の仕様ではありません。
  • OpenAI Decisions は名前付き質問の配列を使い、Cloudflare Clef は独自のエンドポイントと応答形式を使います。移行前に回答、欠落フィールド、エラー、確認処理をアダプターで検証してください。

1. 最初のリクエストを送る

メール認証後にアカウント設定で JevModel API キーを作成します。キーはサーバーに置き、当サイトの /api/v1/systemone に POST してください。下の例は一つの yes/no 質問です。当サイトは OpenRouter 経由で typesafe/jev-1.13 を固定利用するため、model フィールドは送りません。JevModel のキーは TypeSafe の直接 API キーとは異なります。

curl -X POST https://jevmodel.app/api/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"The customer was charged twice and requests a refund.","questions":{"escalate":{"type":"noul","instructions":"Should a human billing specialist review this request now?","criteria":{"true":"A specialist should review it now.","false":"No immediate review is needed."}}}}'

2. リクエスト制限を確認する

文字列、JSON オブジェクト、空でない JSON 配列の state と、一〜八個の名前付き質問を送ります。直列化した state と検証後の全リクエストはそれぞれ 8,000 文字以内です。質問 ID は小文字で始まり、小文字・数字・アンダースコアのみで最大 40 文字。instructions は 8〜600 文字、各 criteria 説明は 2〜350 文字です。Choice は二〜十二候補、Score は二〜十段階、Noul は true と false の説明が必須です。

3. 応答を読む

成功時は下の JevModel 応答形式を使います。data には request_id、質問 ID ごとの answers、上流の usage、残りの quota があります。例の数値は説明用です。Choice は選択ラベルと確率を返し、Score は小数も含む値、Noul は true の確率で 0〜1 の値です。実際の操作に使う閾値はアプリで決めてください。Noul には別の confidence フィールドはありません。

{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "example-id",
    "answers": {
      "escalate": {
        "type": "noul",
        "noul": 0.94
      }
    },
    "usage": {
      "inputTokens": 186
    },
    "quota": {
      "tokenBalance": 99814,
      "hasPurchased": false,
      "signupGrant": 10000,
      "globalUsed": 1,
      "globalLimit": 1000,
      "dayUtc": "2026-09-28"
    }
  }
}

4. エラー・再試行・課金を確認する

エラー形式は {"code":-1,"message":"ERROR_NAME"} です。HTTP 400 は JSON・入力の不備、401 はキー不正、403 はメール未認証、413 はサイズ超過、429 は日次容量・残高不足、502 は無効な上流結果、503 はモデル接続不可です。HTTP と code の両方を確認します。成功した実行ごとに、Playground/API 共通残高(登録特典の 10,000 トークンを含む)から報告された入力トークンを引き、サイト容量の制限を受けます。失敗分の予約は戻ります。冪等キーは未対応です。成功後の応答消失では履歴と残高を調べてから再試行してください。

GitHub の実行例を使う

下の独立 JevModel リポジトリには、問い合わせ分類、見込み客評価、人による確認の curl・Node.js・Python クライアントがあります。クローンしたルートでコマンドを実行します。既定のオフライン例は依存ライブラリやキーが不要で、出力はモデル実測値ではありません。JEVMODEL_API_KEY を設定して --live を付けた場合だけ一回呼び出し、無料枠やトークンを使う可能性があります。自動再試行や業務操作はせず、公式 TypeSafe SDK でもありません。

How to classify text with the JevModel APIJevModel API によるバッチテキスト分類Jev AI Decision Flows と人による確認JevModel の料金と Jev 無料枠
git clone https://github.com/SouthCat196/jevmodel-examples.git
cd jevmodel-examples
node quickstart/node.mjs
# Or: python quickstart/python.py
# Bash / Git Bash: bash quickstart/curl.sh

JevModel は独立したプロジェクトで、TypeSafe AI とは提携していません。