dokumentation
Kontrolpanelets API

Kontrolpanelets API

Markdown

Metoder til det personlige kontrolpanel: login, profil, nøgler og udgiftshistorik.

Komplet guide

Adresser og autorisation

  • Kontrolpanel: https://ailoot.ai (login, kontrolpanelets token)
  • Model-API: https://api.ailoot.ai (sk-…-nøgle)
HvadAdresseGodkendelse
Kontrolpanelets APIhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — kontrolpanelets token efter login
Model-APIhttps://api.ailoot.ai/v1Nøgle sk-… fra afsnittet »API-nøgler«; se Nøgler og API-adresse

Nøgle sk-… erstatter ikke kontrolpanelets token, og kontrolpanelets token giver ikke adgang til model-API'et. Den fulde sti er angivet for hver metode.

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

Svarformat og fejl

Svaret indeholder code, message og data. En fejl kan indeholde reason og metadata. Paginering i data indeholder items, total, page, page_size og pages. Formatet for de enkelte metoder fremgår af deres beskrivelser.

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

Kontrolpanelets token kontrolleres for udløb og for, om brugeren er aktiv; hvis sessionsbinding er aktiveret, kontrolleres også IP og browser. Koderne TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN og FORBIDDEN skelner mellem sessions- og rettighedsproblemer. Frekvensgrænsen og yderligere 2FA-bekræftelse kan blokere en enkelt anmodning.

Sådan læser du referencen

  • Hver post indeholder HTTP-metode, fuld sti, adgang, parametre, felter i anmodningens indhold og svar.
  • Hent identifikatorer fra det tidligere svar: KEY_ID fra GET /api/v1/keys, anmodningens ID fra GET /api/v1/usage.
  • Objekternes felter og typer findes på siderne »Dataskemaer«.
  • Skabelonerne viser feltnavne og typer. PLACEHOLDER og TOKEN er markører; der er ingen rigtige data her.
  • Indbetaling til saldoen findes i kontrolpanelets afsnit »Priser«: sådan indbetaler du.

Saldo og frozen_balance

Profilen indeholder balance og frozen_balance. frozen_balance er beløbet, som er reserveret til uafsluttede anmodninger. Kontrollér begge felter sammen med historikken.

Nøgler og grænser

GET /api/v1/keys returnerer dine nøgler. Felterne quota og quota_used — nøglens forbrugsgrænse og den allerede brugte del; ip_whitelist, ip_blacklist, status og expires_at styrer brugen af nøglen; rate_limit_5h, rate_limit_1d og rate_limit_7d — forbrugsgrænser for tidsvinduer.

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

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

Udgifter og sikkerhed

Historikken og oversigten viser actual_cost — faktisk debitering; total_cost — prisen beregnet efter standardprisen. Filtre for dato, model, nøgle og anmodningstype er angivet for metoden. Ændring af adgangskode, TOTP og passkey kræver de bekræftelser, som beskrives for de pågældende metoder.

I dette afsnit: 39 metoder.

Har du stadig spørgsmål? Send Request ID og en beskrivelse — så hjælper vi med at finde ud af det.Kontakt support