Doku
API des Kundenbereichs

API des Kundenbereichs

Markdown

Methoden des Kundenbereichs: Anmeldung, Profil, Schlüssel und Ausgabenverlauf.

Vollständiger Leitfaden

Adressen und Authentifizierung

  • Kundenbereich: https://ailoot.ai (Anmeldung mit Zugangsdaten, Token des Kundenbereichs)
  • Modell-API: https://api.ailoot.ai (Schlüssel sk-…)
WasAdresseAuthentifizierung
API des Kundenbereichshttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — Token des Kundenbereichs nach der Anmeldung
Modell-APIhttps://api.ailoot.ai/v1Schlüssel sk-… aus dem Bereich „API-Schlüssel“; siehe Schlüssel und API-Adresse

Schlüssel sk-… ersetzt das Token des Kundenbereichs nicht, und dieses Token gewährt keinen Zugriff auf die Modell-API. Der vollständige Pfad steht bei jeder Methode.

Eigenes Profil lesen
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Antwortformat und Fehler

Die Antwort enthält code, message und data. Fehler können reason und metadata enthalten. Die Paginierung in data enthält items, total, page, page_size und pages. Das Format einzelner Methoden steht in deren Beschreibung.

Struktur einer paginierten Antwort
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Beim Token des Kundenbereichs werden Gültigkeitsdauer und aktiver Nutzerstatus geprüft; bei aktivierter Sitzungsbindung zusätzlich IP-Adresse und Browser. Die Codes TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN und FORBIDDEN unterscheiden Sitzungs- und Berechtigungsprobleme. Ein Anfragelimit oder eine zusätzliche 2FA-Bestätigung kann einen einzelnen Request blockieren.

So lesen Sie die Referenz

  • Jeder Eintrag enthält HTTP-Methode, vollständigen Pfad, Zugriff, Parameter, Felder des Request-Bodys und Antwort.
  • Entnehmen Sie IDs der vorherigen Antwort: KEY_ID aus GET /api/v1/keys, die Request-ID aus GET /api/v1/usage.
  • Objektfelder und deren Typen finden Sie auf den Seiten „Datenschemata“.
  • Die Vorlagen zeigen Feldnamen und Typen. PLACEHOLDER und TOKEN sind Platzhalter; echte Daten sind hier nicht enthalten.
  • Guthaben laden Sie unter „Tarife“ im Kundenbereich auf: so laden Sie Guthaben auf.

Guthaben und frozen_balance

Das Profil enthält balance und frozen_balance. frozen_balance ist der für noch nicht abgeschlossene Requests reservierte Betrag. Prüfen Sie beide Felder gemeinsam mit dem Verlauf.

Schlüssel und Limits

GET /api/v1/keys liefert Ihre Schlüssel. Die Felder quota und quota_used — das Ausgabenlimit des Schlüssels und der bereits verbrauchte Anteil; ip_whitelist, ip_blacklist, status und expires_at steuern die Verwendung des Schlüssels; rate_limit_5h, rate_limit_1d und rate_limit_7d — Ausgabenlimits je Zeitfenster.

Liste und eigener Schlüssel
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID ist die id Ihres eigenen Schlüssels aus der Listenantwort
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Ausgaben und Sicherheit

Verlauf und Dashboard zeigen actual_cost — die tatsächliche Abbuchung; total_cost — die Kosten zum Standardpreis. Filter nach Datum, Modell, Schlüssel und Request-Typ stehen bei der Methode. Passwortänderung, TOTP und Passkey erfordern die bei den jeweiligen Methoden beschriebenen Bestätigungen.

In diesem Abschnitt: 39 Methoden.

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.Support kontaktieren