Doku
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-…)
MerkmalAdresseAuthentifizierung
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 API-Schlüssel und API-Adresse

Schlüssel sk-… ersetzt kein Token des Kundenbereichs, 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. Bei Fehlern können reason und metadata enthalten sein. Die Paginierung in data umfasst items, total, page, page_size und pages. Das Format einzelner Methoden steht in deren Beschreibung.

Antwortstruktur mit Paginierung
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Das Token des Kundenbereichs wird auf seine Gültigkeitsdauer und einen aktiven Nutzer geprüft. Ist die Sitzungsbindung aktiviert, werden zusätzlich IP und Browser geprüft. Die Codes TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN und FORBIDDEN unterscheiden Sitzungs- und Berechtigungsprobleme. Ratenlimits und eine zusätzliche 2FA-Bestätigung können eine einzelne Anfrage blockieren.

So lesen Sie die Referenz

  • Jeder Eintrag enthält HTTP-Methode, vollständigen Pfad, Zugriff, Parameter, Felder des Anfrageinhalts und Antwort.
  • Übernehmen Sie Kennungen aus der vorherigen Antwort: KEY_ID aus GET /api/v1/keys, die Anfrage-ID aus GET /api/v1/usage.
  • Objektfelder und ihre Typen stehen auf den Seiten „Datenschemata“.
  • Vorlagen zeigen Feldnamen und Typen. PLACEHOLDER und TOKEN sind Marker; echte Daten sind hier nicht enthalten.
  • Guthabenaufladung im Bereich „Tarife“ des Kundenbereichs: Guthaben aufladen.

Guthaben und frozen_balance

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

Schlüssel und Limits

GET /api/v1/keys liefert Ihre Schlüssel. 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 Verwendung des Schlüssels; rate_limit_5h, rate_limit_1d und rate_limit_7d bezeichnen 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 Listenantwort
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 als tatsächliche Abbuchung und total_cost als Kosten zum Standardpreis. Filter nach Datum, Modell, Schlüssel und Anfragetyp stehen bei der Methode. Änderungen an Passwort, 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, damit wir Ihnen weiterhelfen können.Support kontaktieren