docs
API des Kundenbereichs

API des Kundenbereichs

Markdown

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

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-…)
AspektAdresseAuthentifizierung
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 das Token des Kundenbereichs öffnet die Modell-API nicht. Der vollständige Pfad ist bei jeder Methode angegeben.

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. Paginierung innerhalb von data umfasst 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 die Gültigkeitsdauer und der aktive Benutzerstatus geprüft; ist die Sitzungsbindung aktiviert, zusätzlich IP und Browser. Die Codes TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN und FORBIDDEN unterscheiden Sitzungs- und Berechtigungsprobleme. Ratenlimits und zusätzliche 2FA-Bestätigungen können einzelne Anfragen verhindern.

So lesen Sie die Referenz

  • Jeder Eintrag enthält HTTP-Methode, vollständigen Pfad, Zugriff, Parameter, Felder des Anfragekörpers und Antwort.
  • Übernehmen Sie IDs aus der vorherigen Antwort: KEY_ID aus GET /api/v1/keys, Anfrage-ID aus GET /api/v1/usage.
  • Objektfelder und ihre Typen stehen auf den Seiten «Datenschemata».
  • Die Vorlagen zeigen Feldnamen und Typen. PLACEHOLDER und TOKEN sind Platzhalter; hier stehen keine echten Daten.
  • Guthabenaufladungen finden Sie unter «Tarife» im Kundenbereich: so laden Sie Guthaben auf.

Guthaben und frozen_balance

Das Profil enthält balance und frozen_balance. frozen_balance ist der für laufende Anfragen reservierte Betrag. Prüfen Sie beide Felder zusammen mit dem Verlauf.

Schlüssel und Limits

GET /api/v1/keys gibt Ihre Schlüssel zurück. Die Felder quota und quota_used bezeichnen das Ausgabenlimit des Schlüssels und den bereits verbrauchten Anteil; ip_whitelist, ip_blacklist, status und expires_at steuern die Nutzung des Schlüssels; rate_limit_5h, rate_limit_1d und rate_limit_7d sind Ausgabenlimits für Zeitfenster.

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

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

Kosten und Sicherheit

Verlauf und Dashboard zeigen actual_cost — die tatsächliche Abbuchung; total_cost — die Kosten zum Standardpreis. Datums-, Modell-, Schlüssel- und Anfragetypfilter stehen bei der Methode. Änderungen von Passwort, TOTP und Passkey erfordern die bei den jeweiligen Methoden beschriebenen Bestätigungen.

Dieser Bereich enthält 39 Methoden.

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