API for kontrollpanelet
MarkdownMetoder 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-…)
| Hva | Adresse | Autentisering |
|---|---|---|
| API for kontrollpanelet | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — kontrollpaneltoken etter innlogging |
| Modell-API | https://api.ailoot.ai/v1 | Nø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.
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.
{
"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.
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.