API
API
API Key を使って自分のプログラムから判定を呼び出します。登録で $$5.00 分のクレジットが付きます。jev-1.13.0 と同じく入力トークンのみ、100 万あたり $$0.042、出力は無料です。
アカウントページで Key を発行します。平文は一度だけ表示され、サーバーは sha256 のみを保持します。
アカウントページで Key を発行認証
/v1/* へのリクエストにはすべて Bearer Key が必要です。Key のみを受け付け、ブラウザのセッション Cookie は使いません。Web のログイン状態と課金される呼び出しを分けています。
Authorization: Bearer jev_...エンドポイント
POST /v1/judge | 判定を 1 回実行します。今回の入力トークンで課金され、成功後にのみ差し引かれます。上流の失敗は課金されません。 |
GET /v1/me | 現在のユーザー、残高、累計利用。 |
GET /v1/usage | 残高、累計利用、直近の利用明細。 |
リクエストボディ(/v1/judge)
state | 判定するテキスト、8〜4000 文字。 |
questions | 最大 6 問。キー名は小文字で始まる識別子にしてください。 |
質問タイプ
noul | 関連度。0〜1 の浮動小数点数を返します。 |
confidence | 信頼度。0〜1 の浮動小数点数を返します。 |
choice | 与えられた選択肢から 1 つを選び、選ばれた文字列を返します。options 配列でも criteria オブジェクトでも渡せます。サーバーは options を criteria にまとめてからモデルへ送ります。 |
レスポンス
今回の呼び出し後の残高。
{
"id": "k3f9a1c2b4d5",
"model": "clavue-jev",
"answers": {
"relevance": { "noul": 0.92 },
"confidence": { "noul": 0.78 },
"severity": { "choice": "medium" }
},
"credit": { "cents": 500, "usd": "5.00", "microUsd": 5000000, "inputTokensLeft": 119047619 }
}credit の構造
{
"cents": 500,
"usd": "5.00",
"microUsd": 5000000,
"inputTokensLeft": 119047619
}cents | 残高をセント単位に四捨五入したもの。正確な残高は usd と microUsd を参照。 |
usd | USD 文字列。少額はマイクロドル桁まで保持します。 |
microUsd | 残りのマイクロドル。1 USD = 1,000,000。 |
inputTokensLeft | 100 万あたり $0.042 の入力トークンで、この残高がまかなえる入力トークン数。 |
エラー
| ステータス | error | |
|---|---|---|
401 | unauthorized / invalid_api_key | API Key がないか無効です。 |
400 | invalid_request | state が短すぎるか、質問がありません。 |
429 | quota_exceeded | 残高不足。retry-after が付きます。 |
502 | upstream_unavailable | 判定バックエンドが一時的に利用できません。今回の課金はありません。 |
例
curl https://api.jevcode.ai/v1/judge \
-H "Authorization: Bearer jev_..." \
-H "Content-Type: application/json" \
-d '{
"state": "The build failed on the second job, then passed after a retry.",
"questions": {
"relevance": { "type": "noul", "instructions": "Is this about CI?" },
"confidence": { "type": "confidence", "instructions": "How sure are you?" },
"severity": { "type": "choice", "instructions": "Pick one.",
"options": ["low", "medium", "high"] }
}
}'このまま次のページへ
試用・ドキュメント・事例・料金はつながっています。このページから次のページへ直接進めます。
clavue-jev を使う
ドキュメント
- 紹介このモデルが何を解くのか。
- クイックスタート1 回の呼び出しで動く最小例。
- System One当サイトが書いた概念:状態に型付きの質問を 1 つ。モデルは clavue-jev。
- 状態判定に送るテキスト。
- 信頼度返り値の確かさ。自動実行の可否を決めるのに使う。
- Choice排他的な選択肢から 1 つ選ぶ。
- Noulはい/いいえの質問。はいの確率として返る。
- Score尺度に沿って点数を付ける。
- 意図ルーティングChoice 1 回でリクエストを下流へ振り分ける。
- 信頼度ルーティング信頼度が高ければ自動実行、低ければ人へ。
- ファンアウト1 つの状態に複数の質問を同時に投げる。
- 複合スコアリング複数のスコアを 1 つの順位にまとめる。
- HTTP APISDK を入れない場合のリクエスト形状。
- Python SDKPython から判定を呼ぶ。
- JavaScript SDKJavaScript から判定を呼ぶ。