docs
Paskyros API

Paskyros API

Markdown

Asmeninė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-…)
KasAdresasAutorizacija
Paskyros APIhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — paskyros žetonas po prisijungimo
Modelių APIhttps://api.ailoot.ai/v1Raktas 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.

Savo profilio peržiūra
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.

Atsakymo su puslapiavimu struktūra
{
  "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.

Sąrašas ir nuosavas raktas
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.

Liko klausimų? Atsiųskite Request ID ir aprašymą — padėsime išsiaiškinti.Rašyti pagalbos tarnybai