Jev：状態と質問から構造化された評価結果を得る

Jev が JSON の状態と名前付き質問から boolean、choice、score の評価結果を返す方法を、request、response、料金、コンテキスト上限とともに紹介します。

Jev：状態と質問から構造化された評価結果を得る

Jev は状態データと名前付きの質問を受け取り、boolean、choice、score の型付き回答を返します。評価したい JSON 状態がすでにあり、指定した基準に沿う回答をプログラムで扱いたい場合に利用できます。

Jev が向いているケース

サポート記録、審査結果などの JSON 状態を名前付きの質問で評価し、決まった型の回答を必要とする場合に Jev を使います。各質問に type と instructions を指定します。choice には選択肢と説明、score には順序付きの評価基準を指定できます。

複数ターンの対話、自由形式の説明、文章の作成や書き換えにはチャットモデルを使います。Jev の応答は、名前付き質問に対応する構造化された回答を中心としています。

そのまま使える cURL の例

まず shell で BAZAARLINK_API_KEY を設定してください。以下のリクエストは状態データと3種類の質問を送信します。

curl --include --fail-with-body "${BAZAARLINK_BASE_URL:-https://api.bazaarlink.ai}/v1/evaluations" \
  -H "Authorization: Bearer ${BAZAARLINK_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "typesafe-ai/jev",
  "state": "The support agent issued a full refund and apologised for the delay.",
  "questions": {
    "refunded": {
      "type": "boolean",
      "instructions": "Was a refund issued?"
    },
    "tone": {
      "type": "choice",
      "instructions": "Tone of the agent?",
      "criteria": {
        "apologetic": "The agent apologises",
        "neutral": "No emotional language",
        "hostile": "The agent is rude"
      }
    },
    "quality": {
      "type": "score",
      "instructions": "How complete was the resolution?",
      "criteria": [
        "poor",
        "partial",
        "complete"
      ]
    }
  }
}'

BAZAARLINK_BASE_URL の既定値は https://api.bazaarlink.ai です。このエンドポイントは Jev 専用の evaluations リクエスト形式を使います。現在、API Reference には cURL の例があり、このエンドポイントを直接呼び出す SDK メソッドは掲載されていません。

レスポンス形式

成功時のレスポンスには id、object、model、answers、usage、rounding、warnings が含まれます。answers の key はリクエストで指定した質問名です。boolean の回答には probability が含まれます。choice の回答には選択された choice と、選択肢名を key とする probabilities が含まれます。score の score は criteria 配列の順序に基づき、インデックス 0 から N−1 までの期待値です。probabilities の key は文字列化したインデックス（例："0"、"1"）で、criteria の順序に対応します。この例の score は 1.98 です。トップレベルの rounding は確率とスコアの小数桁数を示し、warnings は今回のレスポンスに関する警告を配列で返します。この例では空配列です。usage には input_tokens、output_tokens、total_tokens が含まれます。

以下は 2026-09-25 に確認した実際のレスポンス形式です。

{
  "id": "eval-a3d350e5-…",
  "object": "evaluation",
  "model": "typesafe-ai/jev",
  "answers": {
    "refunded": {
      "type": "boolean",
      "probability": 0.99
    },
    "tone": {
      "type": "choice",
      "choice": "apologetic",
      "probabilities": {
        "apologetic": 1,
        "neutral": 0,
        "hostile": 0
      }
    },
    "quality": {
      "type": "score",
      "score": 1.98,
      "probabilities": {
        "0": 0,
        "1": 0.02,
        "2": 0.98
      }
    }
  },
  "usage": {
    "input_tokens": 394,
    "output_tokens": 74,
    "total_tokens": 468
  },
  "rounding": {
    "probabilityDecimals": 2,
    "scoreDecimals": 2
  },
  "warnings": []
}

料金と上限

2026-09-25 時点のカタログ価格は、入力100万 tokens あたり USD $0.042、出力100万 tokens あたり USD $0 です。usage には入力・出力それぞれの token 数が記録されます。

コンテキスト上限は32K tokens で、シリアライズ後の state と questions が対象です。

API リファレンス

request の項目、response 例、エラーの詳細は Jev evaluation API reference をご覧ください。

台湾ドル決済・統一発票・主要 AI モデル・OpenAI 互換 API