> ## Documentation Index
> Fetch the complete documentation index at: https://docs.responsibleailabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Referenzübersicht

> Basis-URL, Authentifizierung und vollständige Auflistung der Endpunkte für die RAIL Score API.

## Basis-URL

```
https://api.responsibleailabs.ai
```

## Authentifizierung

Alle Endpunkte (außer `/health`) erfordern ein Bearer-Token:

```
Authorization: Bearer YOUR_RAIL_API_KEY
```

Schlüssel beginnen mit `rail_`. Generieren Sie Ihren im [Dashboard](https://responsibleailabs.ai/dashboard).

## Endpunkte

| Methode | Endpunkt                               | Beschreibung                                                    |
| ------- | -------------------------------------- | --------------------------------------------------------------- |
| `POST`  | `/railscore/v1/eval`                   | Inhalte über 8 RAIL-Dimensionen bewerten                        |
| `POST`  | `/railscore/v1/safe-regenerate`        | Bewerten und neu generieren, bis der Schwellenwert erreicht ist |
| `POST`  | `/railscore/v1/compliance/check`       | Regulatorische Compliance-Prüfung                               |
| `POST`  | `/railscore/v1/agent/tool-call`        | Einen Agenten-Toolaufruf vor der Ausführung bewerten            |
| `POST`  | `/railscore/v1/agent/tool-result`      | Ein Toolergebnis auf PII und Injection scannen                  |
| `POST`  | `/railscore/v1/agent/prompt-injection` | Prompt-Injection in Text erkennen                               |
| `GET`   | `/railscore/v1/config`                 | Die Richtlinie und Konfiguration Ihrer Anwendung lesen          |
| `GET`   | `/railscore/v1/dimensions`             | Die RAIL-Dimensionen sowie Ihre Gewichtungen/Schwellenwerte     |
| `GET`   | `/railscore/v1/capabilities`           | Funktionen und Limits für Ihren Plan                            |
| `POST`  | `/verify`                              | Einen API-Schlüssel überprüfen und Identität anzeigen           |
| `GET`   | `/health`                              | Health-Check des Dienstes                                       |

## Fehlercodes

| Status | Bedeutung                                    |
| ------ | -------------------------------------------- |
| `400`  | Ungültige Anfrage - Parameter prüfen         |
| `401`  | Fehlender oder ungültiger API-Schlüssel      |
| `402`  | Unzureichende Credits                        |
| `403`  | Schlüssel widerrufen oder Plan-Einschränkung |
| `422`  | Validierungsfehler - Inhalt zu kurz/zu lang  |
| `429`  | Rate-Limit überschritten                     |
| `503`  | Dienst vorübergehend nicht verfügbar         |

Alle Fehlerantworten enthalten einen JSON-Body:

```json theme={null}
{
  "error": {
    "code": "insufficient_credits",
    "message": "Requires 3.0 credits, balance is 1.5",
    "required": 3.0,
    "balance": 1.5
  }
}
```