Chiavi API
Creare, delimitare e gestire le chiavi per l'API.
Una chiave API autentica le richieste all'Open API di Reverie. Le chiavi stanno in Impostazioni → Altro → Chiavi API, che è anche dove punta il riquadro Open API di Labs. Qualunque account può crearne — non serve un livello particolare e non c'è un tetto a quante ne tieni.
Creare una chiave
Premi Crea nuova chiave API
Con la pagina vuota, il pulsante dice Crea la tua prima chiave API.
Dalle un nome
Il Nome è obbligatorio, da 1 a 100 caratteri. È così che la chiave viene etichettata nell'elenco e nelle statistiche di utilizzo — "Cassa del salotto", "staging worker".
Scegli Globale o un personaggio preciso
Selezione personaggio è una scelta tra Globale (Tutti i personaggi) e Personaggio specifico, non un extra facoltativo. Il personaggio scelto diventa il personaggio fissato alla chiave.
Se vuoi, imposta tipo di dispositivo e scadenza
Tipo di dispositivo è testo libero (speaker, phone, iot). Scadenza vuole una data e un'ora; in quel momento la chiave smette di funzionare da sola.
La chiave compare subito come rk_ seguito da 64 caratteri esadecimali.
Le chiavi restano consultabili
Il segreto non si vede una volta sola. La scheda di ogni chiave ha Mostra chiave API, Nascondi chiave API e Copia chiave API, in qualsiasi momento, finché la chiave esiste.
Dato che il segreto completo resta leggibile dalle tue impostazioni, considera l'accesso all'account come accesso alla chiave. Tieni la chiave su un server o in un gestore di segreti, mai nel controllo di versione né nel codice del browser.
Chiavi globali e chiavi fissate
| Globale (Tutti i personaggi) | Personaggio specifico | |
|---|---|---|
Cosa restituisce GET /models | I tuoi personaggi recenti | Gli scenari di quel personaggio, o il personaggio stesso se non ne ha |
model omesso | Ripiega sulla tua chat più recente | Usa il personaggio fissato |
| ID brevi di scenario | Non si risolvono mai | Si risolvono sul personaggio fissato |
Disattivare, eliminare, ruotare
| Azione | Effetto | Reversibile |
|---|---|---|
| Interruttore Attivo | Finché è spento, le richieste con quella chiave vengono rifiutate | Sì |
| Elimina | La chiave viene distrutta e le applicazioni che la usano perdono l'accesso | No |
Non esiste una revoca a parte: disattivare ed eliminare sono le due opzioni.
Eliminare una chiave non si può annullare, e si porta via anche la sua attribuzione: il traffico passato finisce nel gruppo Chiavi eliminate delle statistiche di utilizzo, dove non distingui più quale integrazione ha speso cosa. Se la cronologia potrebbe servirti, disattiva prima la chiave.
Per ruotare, crea la chiave sostitutiva, mettila in produzione e solo dopo disattiva o elimina quella vecchia. Non c'è rotazione automatica né periodo di tolleranza dopo la scadenza: una chiave scaduta viene rifiutata con api_key_expired alla richiesta successiva.
Ambiti
Le chiavi portano degli ambiti, e la finestra di creazione non li mostra. Una chiave creata nelle Impostazioni può chiamare gli endpoint di chat, e soltanto quelli.
L'endpoint dell'importatore di personaggi richiede un altro ambito, e l'unico modo di ottenere una chiave così è aprire Labs → Abilità Importazione Personaggi, che te ne crea una chiamata Reverie Character Importer (Skill). Chiamare l'importatore con una normale chiave delle impostazioni restituisce 403. Importare personaggi →
Statistiche di utilizzo
Il pannello Statistiche di utilizzo nella stessa pagina riporta Richieste, Token, Crediti e Chiavi attive, raggruppati per giorno UTC, con il dettaglio per chiave sotto Utilizzo per chiave. Filtra per una chiave o per Tutte le chiavi, su una finestra da 7 a 90 giorni — 30 di default. Vengono contate solo le chat create tramite API.
Questo pannello è l'unico posto in cui la spesa per chiave esiste. La cronologia dei crediti registra quanto è costato ogni messaggio, ma non segna con quale chiave è stato fatto: per confrontare le integrazioni usa quindi le statistiche di qui.
Crea una richiesta
Crea una richiesta apre un generatore: scegli una delle tue chiavi attive, scegli un personaggio o uno scenario dall'elenco che quella chiave vede, scrivi un messaggio, decidi streaming e temperatura, poi copia cURL, TypeScript o Python già funzionanti.
La chiave viene usata nel tuo browser solo per caricare l'elenco dei personaggi. Il codice generato legge REVERIE_API_KEY dall'ambiente invece di incorporare il segreto.
Limiti
| Limite | Valore |
|---|---|
| Chiavi per account | Nessun limite |
| Limite di frequenza per chiave | Nessuno |
| Tetto di concorrenza per chiave | Nessuno |
| Cosa limita davvero l'uso | Il tuo saldo crediti, più la finestra dei modelli gratuiti |
Correlati
- Open API — endpoint, forma della richiesta ed errori
- Importare personaggi — a cosa serve la chiave dell'importatore
- Reverie Labs — i riquadri Open API e importazione
- Sicurezza — il resto delle impostazioni di accesso del tuo account