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 を参照。
usdUSD 文字列。少額はマイクロドル桁まで保持します。
microUsd残りのマイクロドル。1 USD = 1,000,000。
inputTokensLeft100 万あたり $0.042 の入力トークンで、この残高がまかなえる入力トークン数。

エラー

ステータスerror
401unauthorized / invalid_api_keyAPI Key がないか無効です。
400invalid_requeststate が短すぎるか、質問がありません。
429quota_exceeded残高不足。retry-after が付きます。
502upstream_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 を使う

ドキュメント

事例

このサイトの他の入口