Jev API は state と名前付きの型付き質問を受け取り、同じ名前で回答を返します。このガイドでは小さな緊急性チェックを使います。リクエスト形式は公式文書に基づきますが、当サイトの API キーによるライブ検証は行っていません。
1. アクセスを取得し、キーを保護する
公式 Playground で試すか、公式コンソールにログインして API キーを取得します。モデルへのアクセス権と請求条件を確認してください。TYPESAFE_API_KEY はシェル環境変数またはサーバーの秘密情報管理に保存し、公開ページ、リポジトリ、ブラウザーのコードに含めません。
公式アクセス先: Playground · API keys
2. 小さなリクエストを送る
以下の cURL は環境変数で認証し、追跡可能な jev-1.13.0 を指定します。各言語版で同じ英語の state と質問を使っています。他言語の精度は別途評価が必要です。自分のキーで実行すると、課金される可能性がある実際のリクエストが送信されます。
curl --fail-with-body --max-time 30 \
https://api.typesafe.ai/v1/systemone \
-H "Authorization: Bearer $TYPESAFE_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<'JSON'
{
"model": "jev-1.13.0",
"state": "Our payment integration has failed for three days. Please help ASAP.",
"questions": {
"urgency": {
"type": "noul",
"instructions": "Does this message express urgency?"
}
}
}
JSON3. 回答を読む
応答の answers.urgency.noul を確認します。Noul は「はい」の確率であり、テキストラベルではありません。model は回答したバージョン、usage.input_tokens は費用測定の手掛かりです。以下の断片は説明用で、実測の応答ではありません。実際の数値は変わり得ます。
説明用の応答断片:
{
"model": "jev-1.13.0",
"answers": {
"urgency": {
"type": "noul",
"noul": 0.94
}
}
}4. プログラムの動作を決める
型と数値範囲を検証してから使います。例として 0.8 以上を緊急キューに入れ、他は通常処理や人の確認に回せます。ただしこれは公式の安全なしきい値ではありません。ラベル付きデータと見逃し・誤検知の損失から決め、権限管理を回避させないでください。
5. Choice や Score を追加する
部署の振り分けには Choice を使い、請求、技術、営業、その他の criteria を明確にします。順序付き評価には段階の説明を持つ Score を使います。Choice と Score は確率分布と confidence を返しますが、Noul は「はい」の確率を返し、同じ confidence フィールドがあるとは限りません。
6. エラーと変更に対応する
認証失敗ではヘッダー、キー、権限を、無効な要求では JSON と公式スキーマを確認します。429 では retry-after があれば従い、回数制限のあるバックオフを使います。公式 SDK には再試行処理があります。タイムアウトと冪等性を設計し、不正な回答は確認に回してください。モデル変更前にしきい値を再評価します。