メインコンテンツへスキップ
コンセプト: 評価 | Python: client.eval()

​
パラメータ

​
content
string
必須
評価する AI 生成テキスト。10〜10,000 文字である必要があります。
​
mode
string
デフォルト:"basic"
評価モード。"basic" は RAIL のコアスコアリングモデルを実行し、高速なリアルタイムスコアリングを行います。"deep" はより深く詳細な分析を実行し、次元ごとの説明や問題タグも返すことができます。
​
dimensions
string[]
スコアリングする次元のサブセット。8 つすべてをスコアリングするには省略します。選択肢: fairness, safety, reliability, transparency, privacy, accountability, inclusivity, user_impact。
​
weights
object
カスタムの次元の重み。値の合計は 100 である必要があります。例: {"safety": 25, "reliability": 20, ...}。
​
domain
string
ドメインコンテキストのヒント: "general", "healthcare", "legal", "finance", "code"。スコアリングの精度を向上させます。
​
include_explanations
boolean
デフォルト:"false"
次元ごとの説明を含める (deep モードのみ)。
​
include_issues
boolean
デフォルト:"false"
次元ごとに検出された問題タグを含める (deep モードのみ)。
​
include_suggestions
boolean
デフォルト:"false"
次元ごとの改善提案を含める (deep モードのみ)。

​
リクエスト

curl -X POST https://api.responsibleailabs.ai/railscore/v1/eval \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY" \
  -d '{
    "content": "To reset your password, open Settings, choose Security, and select Reset password. We will email you a secure link that expires in 30 minutes.",
    "mode": "basic"
  }'

​
レスポンス

{
  "result": {
    "rail_score": { "score": 7.6, "confidence": 0.51, "summary": "RAIL Score: 7.6/10 — Good" },
    "dimension_scores": {
      "fairness":       { "score": 7.7, "confidence": 0.84 },
      "safety":         { "score": 10.0, "confidence": 0.70 },
      "reliability":    { "score": 7.7, "confidence": 0.16 },
      "transparency":   { "score": 6.5, "confidence": 0.50 },
      "privacy":        { "score": 8.0, "confidence": 0.59 },
      "accountability": { "score": 6.6, "confidence": 0.97 },
      "inclusivity":    { "score": 6.6, "confidence": 0.74 },
      "user_impact":    { "score": 7.8, "confidence": 0.09 }
    },
    "from_cache": false
  },
  "policy_outcome": {
    "enforced": false,
    "enforcement": "block",
    "threshold": 7.0,
    "score": 7.6,
    "passed": true
  },
  "metadata": { "req_id": "abc123", "mode": "basic", "timestamp": "2026-03-31T10:00:00Z" },
  "credits_consumed": 1.0
}
​
policy_outcome
object
アプリケーションのポリシーがこの結果をどう判断したか。
  • enforcement — ポリシーのモード (log_only、block、または regenerate)。
  • threshold — 合格に必要な全体スコア。
  • score — この結果の全体スコア。
  • passed — スコアがしきい値を満たしたかどうか。
  • enforced — 結果に基づいて実際に処理が行われたかどうか。false の場合、ポリシーはモニターモードです。判定は報告されますがレスポンスは変更されないため、何がブロックされうるかを確認できます。現在の状態は GET /config で確認してください。
エンフォースメントが有効で結果が不合格の場合、block ポリシーは 422 POLICY_BLOCKED を返し、regenerate ポリシーはフォールバックを適用する前に安全な書き換えを試みます。
​
result.rail_score.score
number
全体の RAIL スコア (0.0〜10.0)。評価されたすべての次元の加重平均。
​
result.rail_score.confidence
number
スコアに対するモデルの信頼度 (0.0〜1.0)。
​
result.dimension_scores
object
次元ごとのスコア。各エントリは score (0〜10) と confidence (0〜1) を持ちます。deep モードでは explanation、issues、suggestions も含まれます。
​
result.from_cache
boolean
この結果がキャッシュから返された場合は true (0 クレジット)。
​
credits_consumed
number
このリクエストに対して課金されたクレジット。キャッシュされたレスポンスの場合は 0。