Zum Hauptinhalt springen
Alle RAIL API-Anfragen werden mit API-Schlüsseln authentifiziert. Die Schlüssel sind an Ihr Konto gebunden, tragen Ihr Guthaben und erscheinen in Ihren Nutzungsprotokollen.

​
API-Schlüssel erhalten

1

Registrieren

Erstellen Sie ein kostenloses Konto bei responsibleailabs.ai.
2

Öffnen Sie Ihr Dashboard

Gehen Sie zu Ihrem Dashboard und navigieren Sie zum Abschnitt API-Schlüssel.
3

Schlüssel generieren

Klicken Sie auf Schlüssel generieren. Die Schlüssel beginnen mit rail_ und werden genau einmal angezeigt. Kopieren Sie Ihren sofort.
Ihr Schlüssel wird nach dem Schließen des Dialogs nicht mehr angezeigt. Bewahren Sie ihn sicher auf, bevor Sie die Seite verlassen.

​
Verwendung des API-Schlüssels

Übergeben Sie Ihren Schlüssel als Bearer-Token im Authorization-Header bei jeder Anfrage: 
Authorization: Bearer YOUR_RAIL_API_KEY
Vollständiges cURL-Beispiel: 
curl -X POST https://api.responsibleailabs.ai/railscore/v1/eval \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Ihr von KI generierter Text hier", "mode": "basic"}'

​
SDK-Authentifizierung

Beide SDKs akzeptieren den API-Schlüssel bei der Client-Konstruktion und fügen den Header automatisch hinzu: 
from rail_score_sdk import RailScoreClient
import os

# Schlüssel direkt übergeben (in Ordnung für Skripte)
client = RailScoreClient(api_key="YOUR_RAIL_API_KEY")

# Empfohlen: aus Umgebungsvariable lesen
client = RailScoreClient(api_key=os.environ["RAIL_API_KEY"])

​
Umgebungsvariablen

API-Schlüssel niemals in Quellcodedateien hartkodieren. Verwenden Sie Umgebungsvariablen und halten Sie Schlüssel aus der Versionskontrolle heraus. 
# .env  — zu .gitignore hinzufügen, diese Datei niemals committen
RAIL_API_KEY=YOUR_RAIL_API_KEY

from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.environ["RAIL_API_KEY"]

​
Schlüsselverwaltung

Sie können mehrere Schlüssel für verschiedene Umgebungen (Produktion, Staging, CI) erstellen. Verwalten Sie alle Schlüssel von Ihrem Dashboard.
AktionWann zu verwenden
Schlüssel generierenNeue Umgebung, Einarbeitung eines neuen Dienstes oder planmäßiges Rotieren von Anmeldeinformationen
Schlüssel umbenennenKontext hinzufügen wie “production-chatbot” oder “staging-ci” zur Nutzungstracking
Schlüssel widerrufenVerdacht auf Leck, Mitarbeiterabgang oder Stilllegung eines Dienstes. Wirkt sofort.
Null-Downtime-Rotation: Generieren Sie einen neuen Schlüssel, implementieren Sie ihn in Ihrem Dienst und überprüfen Sie, ob er funktioniert, und widerrufen Sie dann den alten Schlüssel. Der Austausch dauert Sekunden.

​
Ratenlimits

Ratenlimits werden pro API-Schlüssel angewendet. Das Überschreiten des Limits gibt HTTP 429 zurück.
PlanAnfragen / minAnfragen / Tag
Kostenlos10100
Pro605.000
Geschäftlich30050.000
EnterpriseBenutzerdefiniertBenutzerdefiniert

​
Sicherheitsbest Practices

  • Schlüssel niemals im Client-seitigen Code exponieren. Browser sind öffentlich. Rufen Sie die API immer von Ihrem Backend oder serverlosen Funktion auf.
  • Schlüssel in Umgebungsvariablen speichern, niemals hartkodiert in Quellcodedateien oder Docker-Images.
  • Fügen Sie .env zu .gitignore hinzu, bevor Sie den ersten Commit machen, damit Schlüssel niemals versehentlich gepusht werden.
  • Verwenden Sie separate Schlüssel pro Umgebung. Wenn Staging kompromittiert wird, bleibt die Produktion sicher.
  • Sofort widerrufen, wenn exponiert. Zuerst einen Ersatz generieren, dann widerrufen.
  • Planmäßig rotieren. Periodisches Regenerieren von Schlüsseln begrenzt den Schadensradius eines unentdeckten Lecks.

​
Auth-Fehlerantworten

StatusFehlerBehebung
401Fehlender oder fehlerhafter Authorization-HeaderFügen Sie Authorization: Bearer … hinzu
401Ungültiger API-SchlüsselÜberprüfen Sie, ob der Schlüssel mit rail_ beginnt und korrekt kopiert wurde
403API-Schlüssel widerrufen oder inaktivGenerieren Sie einen neuen Schlüssel im Dashboard
429Ratenlimit überschrittenReduzieren Sie die Anfragefrequenz oder upgraden Sie den Plan

​
Was kommt als Nächstes

Schnellstart

Machen Sie Ihre erste Bewertungsanfrage in weniger als 5 Minuten.

Guthaben & Preise

Verstehen, wie Guthaben pro Anfrage berechnet werden.

API-Referenz

Vollständige Parameterreferenz für alle Endpunkte.

Dashboard

Verwalten Sie Schlüssel, sehen Sie die Nutzung und überwachen Sie das Guthaben.