Passer au contenu principal
Concept : Évaluation | Python : client.eval()

​
Paramètres

​
content
string
requis
Le texte généré par IA à évaluer. Doit contenir entre 10 et 10 000 caractères.
​
mode
string
défaut:"basic"
Mode d’évaluation : "basic" (classificateur ML, rapide, 1.0 crédit) ou "deep" (LLM-as-judge, 2–5s, 3.0 crédits).
​
dimensions
string[]
Sous-ensemble de dimensions à évaluer. Omettez ce paramètre pour évaluer les 8. Options : fairness, safety, reliability, transparency, privacy, accountability, inclusivity, user_impact.
​
weights
object
Pondérations personnalisées par dimension. Les valeurs doivent totaliser 100. Ex. : {"safety": 25, "reliability": 20, ...}.
​
domain
string
Indication de contexte métier : "general", "healthcare", "legal", "finance", "code". Améliore la précision de l’évaluation.
​
include_explanations
boolean
défaut:"false"
Inclure les explications par dimension (mode deep uniquement).
​
include_issues
boolean
défaut:"false"
Inclure les problèmes détectés par dimension (mode deep uniquement).
​
include_suggestions
boolean
défaut:"false"
Inclure les suggestions d’amélioration par dimension (mode deep uniquement).

​
Requête

curl -X POST https://api.responsibleailabs.ai/railscore/v1/eval \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY" \
  -d '{
    "content": "Establishing a consistent sleep schedule improves sleep quality.",
    "mode": "basic"
  }'

​
Réponse

{
  "result": {
    "rail_score": { "score": 8.6, "confidence": 0.87, "summary": "RAIL Score: 8.6/10 -- Good" },
    "dimension_scores": {
      "fairness":       { "score": 9.0, "confidence": 0.90 },
      "safety":         { "score": 9.0, "confidence": 0.88 },
      "reliability":    { "score": 8.0, "confidence": 0.82 },
      "transparency":   { "score": 8.5, "confidence": 0.85 },
      "privacy":        { "score": 5.0, "confidence": 1.00 },
      "accountability": { "score": 8.5, "confidence": 0.84 },
      "inclusivity":    { "score": 9.0, "confidence": 0.90 },
      "user_impact":    { "score": 8.5, "confidence": 0.86 }
    },
    "from_cache": false
  },
  "metadata": { "req_id": "abc123", "mode": "basic", "timestamp": "2026-03-31T10:00:00Z" },
  "credits_consumed": 1.0
}
​
result.rail_score.score
number
Score RAIL global (0.0–10.0), moyenne pondérée de toutes les dimensions évaluées.
​
result.rail_score.confidence
number
Confiance du modèle dans le score (0.0–1.0).
​
result.dimension_scores
object
Scores par dimension. Chaque entrée contient score (0–10) et confidence (0–1). En mode deep : également explanation, issues, suggestions.
​
result.from_cache
boolean
true si ce résultat provient du cache (0 crédit facturé).
​
credits_consumed
number
Crédits facturés pour cette requête. 0 pour les réponses en cache.