dokumentation
Kontrollpanelens API

Kontrollpanelens API

Markdown

Kontrollpanelens 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-…)
VadAdressAutentisering
Kontrollpanelens APIhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — kontrollpaneltoken efter inloggning
Modell-APIhttps://api.ailoot.ai/v1Nyckel 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.

Läs din egen profil
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.

Svarsstruktur med paginering
{
  "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.

Lista och egen nyckel
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.

Har du fler frågor? Skicka Request ID och en beskrivning, så hjälper vi dig.Kontakta supporten