Paskyros API
MarkdownAsmeninės paskyros metodai: prisijungimas, profilis, raktai ir išlaidų istorija.
Visas vadovas
Adresai ir autorizacija
- Paskyra: https://ailoot.ai (prisijungimas, paskyros žetonas)
- Modelių API: https://api.ailoot.ai (raktas sk-…)
| Kas | Adresas | Autorizacija |
|---|---|---|
| Paskyros API | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — paskyros žetonas po prisijungimo |
| Modelių API | https://api.ailoot.ai/v1 | Raktas sk-… iš skilties „API raktai“; žr. Raktai ir API adresas |
Raktas sk-… nepakeičia paskyros žetono, o paskyros žetonas nesuteikia prieigos prie modelių API. Visas kelias nurodytas prie kiekvieno metodo.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Atsakymo formatas ir klaidos
Atsakyme yra code, message ir data. Klaidoje gali būti reason ir metadata. Puslapiavimas data objekte apima items, total, page, page_size ir pages. Atskirų metodų formatas nurodytas jų aprašymuose.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}Paskyros žetonas tikrinamas pagal galiojimo laiką ir vartotojo aktyvumą; jei įjungtas seanso susiejimas, dar ir pagal IP bei naršyklę. Kodai TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN ir FORBIDDEN atskiria seanso ir teisių problemas. Dažnio limitas ir papildomas 2FA patvirtinimas gali užblokuoti atskirą užklausą.
Kaip skaityti žinyną
- Kiekviename įraše yra HTTP metodas, visas kelias, prieiga, parametrai, turinio laukai ir atsakymas.
- Identifikatorius imkite iš ankstesnio atsakymo: KEY_ID — iš GET /api/v1/keys, užklausos ID — iš GET /api/v1/usage.
- Objektų laukai ir jų tipai pateikti puslapiuose „Duomenų schemos“.
- Šablonai rodo laukų pavadinimus ir tipus. PLACEHOLDER ir TOKEN yra žymekliai, tikrų duomenų čia nėra.
- Balanso papildymas — paskyros skiltyje „Planai“: kaip papildyti.
Balansas ir frozen_balance
Profilyje yra balance ir frozen_balance. frozen_balance — suma, rezervuota nebaigtoms užklausoms. Tikrinkite abu laukus kartu su istorija.
Raktai ir limitai
GET /api/v1/keys grąžina jūsų raktus. Laukai quota ir quota_used — rakto išlaidų limitas ir jau išleista dalis; ip_whitelist, ip_blacklist, status ir expires_at valdo rakto naudojimą; rate_limit_5h, rate_limit_1d ir rate_limit_7d — išlaidų limitai per laiko langus.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID — jūsų rakto id iš sąrašo atsakymo
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Išlaidos ir saugumas
Istorija ir dashboard rodo actual_cost — faktinį nurašymą; total_cost — kainą pagal standartinį įkainį. Datos, modelio, rakto ir užklausos tipo filtrai nurodyti prie metodo. Slaptažodžio keitimas, TOTP ir passkey reikalauja patvirtinimų, aprašytų prie atitinkamų metodų.
Šioje skiltyje: 39 metodai.