Kontrolpanelets API
MarkdownMetoder 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)
| Hvad | Adresse | Godkendelse |
|---|---|---|
| Kontrolpanelets API | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — kontrolpanelets token efter login |
| Model-API | https://api.ailoot.ai/v1 | Nø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.
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.
{
"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.
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.