dokumentasjon
API for kontrollpanelet

API for kontrollpanelet

Markdown

Metoder for kontrollpanelet: innlogging, profil, nøkler og forbrukshistorikk.

Fullstendig guide

Adresser og autentisering

  • Kontrollpanel: https://ailoot.ai (innlogging med brukernavn, kontrollpaneltoken)
  • Modell-API: https://api.ailoot.ai (nøkkel sk-…)
HvaAdresseAutentisering
API for kontrollpanelethttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — kontrollpaneltoken etter innlogging
Modell-APIhttps://api.ailoot.ai/v1Nøkkel sk-… fra seksjonen «API-nøkler»; se Nøkler og API-adresse

Nøkkel sk-… erstatter ikke kontrollpaneltokenet, og kontrollpaneltokenet gir ikke tilgang til modell-API-et. Fullstendig endepunkt er angitt for hver metode.

Les din egen profil
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Svarformat og feil

Svaret inneholder code, message og data. Feil kan inneholde reason og metadata. Paginering i data inneholder items, total, page, page_size og pages. Formatet for hver metode er angitt i beskrivelsen.

Svarstruktur med paginering
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Kontrollpaneltokenet kontrolleres for utløp og om brukeren er aktiv; hvis øktbinding er aktivert, kontrolleres også IP og nettleser. Kodene TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN og FORBIDDEN skiller mellom økt- og rettighetsproblemer. Frekvensgrenser og ekstra 2FA-bekreftelse kan blokkere en enkelt forespørsel.

Slik leser du referansen

  • Hver oppføring inneholder HTTP-metode, fullstendig endepunkt, tilgang, parametere, felter i forespørselskroppen og svar.
  • Hent identifikatorene fra et tidligere svar: KEY_ID — fra GET /api/v1/keys, forespørsels-ID — fra GET /api/v1/usage.
  • Objektfelter og typer finnes på sidene «Dataskjemaer».
  • Malene viser feltnavn og typer. PLACEHOLDER og TOKEN er markører; her finnes ingen faktiske data.
  • Legg til midler i seksjonen «Priser» i kontrollpanelet: slik legger du til midler.

Saldo og frozen_balance

Profilen inneholder balance og frozen_balance. frozen_balance er beløpet som er reservert for uferdige forespørsler. Kontroller begge feltene sammen med historikken.

Nøkler og grenser

GET /api/v1/keys returnerer nøklene dine. Feltene quota og quota_used — nøkkelens forbruksgrense og beløpet som allerede er brukt; ip_whitelist, ip_blacklist, status og expires_at styrer hvordan nøkkelen kan brukes; rate_limit_5h, rate_limit_1d og rate_limit_7d — forbruksgrenser per tidsvindu.

Liste og egen nøkkel
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID er id til din egen nøkkel fra listesvaret
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Forbruk og sikkerhet

Historikken og oversikten viser actual_cost — faktisk belastning; total_cost — kostnad til standardpris. Dato-, modell-, nøkkel- og forespørselstypefiltre er angitt for metoden. Endring av passord, TOTP og passnøkkel krever bekreftelsene som beskrives for de aktuelle metodene.

I denne seksjonen: 39 metoder.

Flere spørsmål? Send Request ID og en beskrivelse, så hjelper vi deg.Kontakt brukerstøtte