API des Kundenbereichs
MarkdownMethoden 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-…)
| Was | Adresse | Authentifizierung |
|---|---|---|
| API des Kundenbereichs | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — Token des Kundenbereichs nach der Anmeldung |
| Modell-API | https://api.ailoot.ai/v1 | Schlü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.
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.
{
"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.
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.