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-…)
| Merkmal | 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 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.
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.
{
"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.
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.