判定 API

判定モデルは自由文を生成せず、与えられた状態について構造化された質問に回答します。OpenAI / Anthropic 互換ではありません。/v1 base URL 配下になく、OpenAI や Anthropic の SDK からは呼び出せません。

状態	Method	Path	用途
対応	`POST`	`/typesafe/v1/systemone`	TypeSafe System One 判定モデル

認証、クレジット消費、エラー形式、x-request-id / request-id レスポンスヘッダーは、モデル API の他のパスと同じです。Tokener.ai API キーは Bearer として送信します。レスポンスは単一の JSON オブジェクトです。

リクエスト

Shell

curl https://api.tokener.dev/typesafe/v1/systemone \
  -H "Authorization: Bearer $TOKENER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "The customer cannot sign in.",
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Route this request.",
        "criteria": {
          "technical": "Technical support",
          "billing": "Billing"
        }
      }
    }
  }'

state は判定対象のテキストです。questions の各エントリがその状態に対する 1 つの質問で、criteria が許可される回答を列挙します。エントリを増やせば 1 回のリクエストで複数の質問を尋ねられます。

レスポンス

JSON

{
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 1.0,
      "probabilities": { "technical": 1.0, "billing": 0.0 }
    }
  },
  "usage": { "input_tokens": 310, "output_tokens": 31 }
}

各回答は質問に付けたキーをそのまま保持するため、結果は名前で対応付けられます。 confidence と probabilities を使えば、確信度の低いケースを choice に従わず人間に回せます。

モデルと価格

判定モデルはモデルカタログの判定カテゴリに掲載され、100 万トークンあたりの公開価格が表示されます。model フィールドにはカタログのモデル id（例: jev-latest）を渡します。

呼び出す前に API キーでキーを作成してください。エラーレスポンス形式と完全なエラーコード表はエラーを参照してください。