Kontrollpanelens API
MarkdownKontrollpanelens metoder: inloggning, profil, nycklar och förbrukningshistorik.
Fullständig guide
Adresser och autentisering
- Kontrollpanel: https://ailoot.ai (inloggning med användarnamn, kontrollpaneltoken)
- Modell-API: https://api.ailoot.ai (nyckel sk-…)
| Vad | Adress | Autentisering |
|---|---|---|
| Kontrollpanelens API | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — kontrollpaneltoken efter inloggning |
| Modell-API | https://api.ailoot.ai/v1 | Nyckel sk-… från avsnittet ”API-nycklar”; se Nycklar och API-adress |
Nyckel sk-… ersätter inte kontrollpaneltoken, och kontrollpaneltoken ger inte åtkomst till modell-API:t. Fullständig sökväg anges för varje metod.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Svarsformat och fel
Svaret innehåller code, message och data. Ett fel kan innehålla reason och metadata. Paginering i data innehåller items, total, page, page_size och pages. Formatet för varje metod anges i beskrivningen.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}Kontrollpaneltoken kontrolleras med avseende på giltighetstid och om användaren är aktiv; om sessionsbindning är aktiverad kontrolleras även IP och webbläsare. Koderna TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN och FORBIDDEN skiljer mellan problem med session och behörighet. Frekvensgränser och extra 2FA-bekräftelse kan blockera ett enskilt anrop.
Så läser du referensen
- Varje post innehåller HTTP-metod, fullständig sökväg, åtkomst, parametrar, fält i anropskroppen och svar.
- Hämta identifierarna från ett tidigare svar: KEY_ID — från GET /api/v1/keys, anropets ID — från GET /api/v1/usage.
- Objektfält och deras typer finns på sidorna ”Datascheman”.
- Mallarna visar fältnamn och typer. PLACEHOLDER och TOKEN är markörer; inga faktiska data visas här.
- Fyll på saldot under ”Priser” i kontrollpanelen: så fyller du på.
Saldo och frozen_balance
Profilen innehåller balance och frozen_balance. frozen_balance är beloppet som reserverats för anrop som inte är avslutade. Kontrollera båda fälten tillsammans med historiken.
Nycklar och gränser
GET /api/v1/keys returnerar dina nycklar. Fälten quota och quota_used — nyckelns utgiftsgräns och det belopp som redan har förbrukats; ip_whitelist, ip_blacklist, status och expires_at styr hur nyckeln får användas; rate_limit_5h, rate_limit_1d och rate_limit_7d — utgiftsgränser per tidsfönster.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID — id för din egen nyckel i listsvaret
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Förbrukning och säkerhet
Historiken och översikten visar actual_cost — faktisk debitering; total_cost — kostnad till standardpris. Filter för datum, modell, nyckel och anropstyp anges för metoden. Ändring av lösenord, TOTP och passnyckel kräver de bekräftelser som beskrivs för respektive metod.
I detta avsnitt: 39 metoder.