Source: https://ailoot.ai/docs/it/cabinet/
Canonical: https://ailoot.ai/docs/it/cabinet/
Language: it

[API dell’area personale](https://ailoot.ai/docs/it/) 

# API dell’area personale

[Markdown](https://ailoot.ai/docs/it/cabinet/index.md)

Metodi dell’area personale: accesso, profilo, chiavi e cronologia delle spese.

Questa è l’API dell’area personale di ailoot.ai: accesso, profilo, chiavi e cronologia delle spese. Le richieste ai modelli vanno a un altro indirizzo — `https://api.ailoot.ai` con la chiave `sk-…`. L’accesso ai metodi dipende dai permessi del tuo account e dalle funzioni abilitate.

## [](https://ailoot.ai/docs/it/cabinet/#adresa-i-avtorizatsiya)Indirizzi e autorizzazione

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

| Voce | Indirizzo | Autorizzazione |
| --- | --- | --- |
| API dell’area personale | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — token dell’area personale dopo l’accesso |
| API dei modelli | `https://api.ailoot.ai/v1` | Chiave `sk-…` dalla sezione «Chiavi API»; vedi [Chiavi e indirizzo API](https://ailoot.ai/docs/it/keys/) |

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.

Lettura del proprio profilo

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

## [](https://ailoot.ai/docs/it/cabinet/#format-otveta-i-oshibki)Formato della risposta ed errori

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.

Struttura della risposta paginata

```json
{
  "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.

## [](https://ailoot.ai/docs/it/cabinet/#kak-chitat-spravochnik)Come leggere la guida di riferimento

- 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](https://ailoot.ai/docs/it/billing/topup/).

## [](https://ailoot.ai/docs/it/cabinet/#balans-i-frozen-balance)Saldo e frozen\_balance

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

## [](https://ailoot.ai/docs/it/cabinet/#klyuchi-i-limity)Chiavi e limiti

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.

Elenco e propria chiave

```bash
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"
```

## [](https://ailoot.ai/docs/it/cabinet/#rashody-i-bezopasnost)Spese e sicurezza

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.

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.