Hallintapaneelin API

• Hallintapaneeli: https://ailoot.ai (kirjautuminen tunnuksella, hallintapaneelin token)
• Mallien API: https://api.ailoot.ai (avain sk-…)

Avain sk-… ei korvaa hallintapaneelin tokenia, eikä hallintapaneelin token avaa mallien APIa. Kunkin metodin koko polku ilmoitetaan sen kohdalla.

curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Vastaus sisältää code-, message- ja data-kentät. Virheessä voivat esiintyä reason ja metadata. Sivutus data-kentässä sisältää items-, total-, page-, page_size- ja pages-kentät. Kunkin metodin muoto ilmoitetaan sen kuvauksessa.

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

Hallintapaneelin tokenista tarkistetaan voimassaoloaika ja käyttäjän aktiivisuus; jos istunnon sitominen on käytössä, myös IP ja selain. Koodit TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN ja FORBIDDEN erottavat istunto- ja käyttöoikeusongelmat. Pyyntötiheyden raja ja ylimääräinen 2FA-vahvistus voivat estää yksittäisen pyynnön.

• Jokainen merkintä sisältää HTTP-metodin, koko polun, käyttöoikeuden, parametrit, rungon kentät ja vastauksen.
• Ota tunnisteet aiemmasta vastauksesta: KEY_ID metodista GET /api/v1/keys, pyynnön ID metodista GET /api/v1/usage.
• Objektien kentät ja niiden tyypit löytyvät ”Tietoskeemat”-sivuilta.
• Mallipohjat näyttävät kenttien nimet ja tyypit. PLACEHOLDER ja TOKEN ovat merkkejä; tässä ei ole oikeita tietoja.
• Saldon lataaminen on hallintapaneelin ”Hinnoittelu”-osiossa: näin lataat saldoa.

Profiili sisältää balance- ja frozen_balance-kentät. frozen_balance on keskeneräisille pyynnöille varattu summa. Tarkista molemmat kentät yhdessä historian kanssa.

GET /api/v1/keys palauttaa omat avaimesi. Kentät quota ja quota_used — avaimen kulutusraja ja jo käytetty osuus; ip_whitelist, ip_blacklist, status ja expires_at ohjaavat avaimen käyttöä; rate_limit_5h, rate_limit_1d ja rate_limit_7d — jaksojen kulutusrajat.

curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — oman avaimesi id listavastauksesta
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Historia ja yleisnäkymä näyttävät actual_cost-arvon — toteutuneen veloituksen; total_cost on vakiohinnan mukainen hinta. Päivämäärä-, malli-, avain- ja pyyntötyyppisuodattimet ilmoitetaan metodin kohdalla. Salasanan, TOTP:n ja pääsyavaimen muutokset vaativat kyseisten metodien kohdalla kuvatut vahvistukset.

Tässä osiossa: 39 metodia.