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