API dell’area personale

• Area personale: https://ailoot.ai (accesso con credenziali, token dell’area personale)
• API dei modelli: https://api.ailoot.ai (chiave sk-…)

Chiave sk-… non sostituisce il token dell’area personale, e il token dell’area personale non dà accesso all’API dei modelli. Il percorso completo è indicato per ogni metodo.

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

La risposta contiene code, message e data. Negli errori possono comparire reason e metadata. La paginazione in data contiene items, total, page, page_size e pages. Il formato di ciascun metodo è indicato nella sua descrizione.

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

Il token dell’area personale è verificato per scadenza e stato attivo dell’utente; se il vincolo della sessione è abilitato, anche per IP e browser. I codici TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN e FORBIDDEN distinguono problemi di sessione e permessi. Il limite di frequenza e una conferma 2FA aggiuntiva possono bloccare una singola richiesta.

• Ogni voce contiene metodo HTTP, percorso completo, accesso, parametri, campi del corpo e risposta.
• Prendi gli identificatori dalla risposta precedente: KEY_ID da GET /api/v1/keys, ID della richiesta da GET /api/v1/usage.
• Campi degli oggetti e relativi tipi sono nelle pagine «Schemi dei dati».
• I template mostrano nomi e tipi dei campi. PLACEHOLDER e TOKEN sono segnaposto, non dati reali.
• La ricarica del saldo è nella sezione «Tariffe» dell’area personale: come ricaricare.

Il profilo contiene balance e frozen_balance. frozen_balance è l’importo riservato per richieste non concluse. Controlla entrambi i campi insieme alla cronologia.

GET /api/v1/keys restituisce le tue chiavi. I campi quota e quota_used — limite di spesa della chiave e quota già spesa; ip_whitelist, ip_blacklist, status e expires_at regolano l’uso della chiave; rate_limit_5h, rate_limit_1d e rate_limit_7d — limiti di spesa per finestre.

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

# KEY_ID — id della propria chiave nella risposta dell'elenco
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

La cronologia e la dashboard mostrano actual_cost — l’addebito effettivo; total_cost — il costo al prezzo standard. I filtri per data, modello, chiave e tipo di richiesta sono indicati nel metodo. Modifiche a password, TOTP e passkey richiedono le conferme descritte nei rispettivi metodi.

In questa sezione: 39 metodi.