Chiave API Character AI: come ottenerla e usarla
Se hai cercato una chiave API Character AI, la prima cosa da sapere è che questo sito non è Character.ai e non emette le sue chiavi. Ti fornisce una chiave per un'API testuale indipendente e compatibile con OpenAI che funziona come backend pronto all'uso per le app di chat con personaggi.
Aggiornato

Punti chiave
- Ottieni una chiave dopo esserti registrato con Google o email e password, quindi aprendo la pagina della chiave API.
- I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, senza bisogno di carta, valido per 7 giorni.
- Usa l'URL di base https://api.characteraiapi.com/v1 e l'ID del modello
uncensoredcon qualsiasi SDK OpenAI. - Tieni la chiave su un server o in una variabile d'ambiente, mai nel codice front-end pubblico.
Cosa ottieni effettivamente
Character.ai è un prodotto chat per il consumatore. Chi cerca una chiave API di Character AI di solito vuole una di queste due cose: un modo per chiamare un chatbot personaggio dal proprio codice, oppure un backend per un'app persona che non sia limitato dalle regole di un prodotto ospitato. Questo sito copre la seconda necessità. Ti registri, ricevi una chiave e invii richieste a un endpoint compatibile con OpenAI. Nulla qui si collega a Character.ai o riutilizza i suoi personaggi.
Il servizio è un'API testuale ospitata davanti a un unico modello a pesi aperti, gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti di contenuti per l'uso adulto legale. Non è l'API ufficiale di alcun fornitore di modelli e non è un router tra fornitori. L'ID del modello è uncensored, e l'URL di base è https://api.characteraiapi.com/v1. Esistono due metodi: POST /v1/chat/completions e GET /v1/models.
Poiché l'interfaccia corrisponde a quella di OpenAI, il lavoro di creazione di un personaggio è dalla tua parte. Scrivi la personalità come messaggio di sistema, mantieni la cronologia delle conversazioni e inviala con ogni richiesta. Questo ti dà il controllo su voce, memoria e ritmo che un prodotto chiuso raramente espone. Il limite rigido è lo stesso per tutti gli utenti: nessun contenuto sessuale che coinvolga minorenni, mai.
Ottieni la tua chiave in cinque passaggi
L'intero percorso richiede pochi minuti. Non hai bisogno di una carta per iniziare.
- Registrati. Usa Google, oppure registrati con email e password.
- Apri la pagina della chiave. Vai alla pagina della chiave API, dove viene mostrata la chiave del tuo account.
- Richiedi il credito di prova. Un clic in quella pagina aggiunge $0,50 di credito di prova. È limitato a uno per persona ed è valido per 7 giorni.
- Copia la chiave. Salvala in un gestore di password o in un file di segreti subito.
- Invia una richiesta di test. Usa il comando curl di seguito prima di toccare qualsiasi codice dell'app.
Tratta la chiave come una password. Chiunque la abbia può spendere il tuo saldo. Se pensi che sia trapelata, smetti di usarla subito, rimuovila da ogni app e controlla il tuo saldo per spese inaspettate.
Prova la chiave con curl
Imposta la chiave come variabile d'ambiente in modo che non finisca mai nella cronologia del tuo shell come testo normale all'interno di uno script. Poi elenca i modelli. Questo conferma che la chiave funziona e che raggiungi l'host corretto.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Dovresti ottenere un elenco JSON che include uncensored. Ora invia una prima richiesta chat con un breve profilo del personaggio. Il messaggio di sistema imposta il personaggio, il messaggio dell'utente avvia la scena.
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'La risposta segue la forma standard delle chat completions. Il testo della risposta si trova in choices[0].message.content. Le intestazioni di risposta contengono anche X-Request-Id, X-Balance-USD e le intestazioni del limite di richieste, utile quando vuoi mostrare il saldo residuo nella tua interfaccia.
Usa la chiave da Python o Node
Qualsiasi SDK OpenAI funziona una volta modificati due valori: l'URL di base e la chiave. Ecco la versione Python con il pacchetto ufficiale openai.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)E la stessa chiamata in Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);Molte interfacce chat hanno un campo per un endpoint personalizzato compatibile con OpenAI. In questi strumenti incolli l'URL di base, incolla la chiave e digita uncensored come nome del modello. Nient'altro deve cambiare. La pagina documentazione elenca i parametri supportati, inclusi streaming, chiamata di funzioni e modalità JSON.
Problemi comuni con le chiavi e soluzioni rapide
La maggior parte dei fallimenti per la prima volta deriva da un paio di piccoli errori. Controllali in questo ordine prima di sospettare qualcosa di più grande.
- Spazi bianchi extra o virgolette nella chiave. Una nuova riga finale copiata da un file è sufficiente per far fallire l'autenticazione. Stampa la lunghezza della variabile e confrontala con ciò che hai copiato.
- URL di base errato. L'URL di base termina con
/v1, e l'SDK aggiunge/chat/completionsda solo. Se aggiungi anche/chat/completionsall'URL di base, il percorso si duplica e la richiesta fallisce. - Nome del modello errato. L'ID del modello è
uncensored. I nomi presi in prestito da altri servizi non corrisponderanno. ChiamaGET /v1/modelsper vedere cosa riporta il server. - Intestazione mancante. Le chiamate HTTP grezze necessitano di
Authorization: Bearerseguito da uno spazio e la chiave, piùContent-Type: application/jsonsulle richieste POST. - Saldo vuoto. L'intestazione di risposta
X-Balance-USDmostra ciò che rimane. Quando il credito di prova è esaurito o passato i 7 giorni, ricarica o le richieste smetteranno di avere successo. - Limiti di richiesta. Una chiave di prova consente 2 richieste parallele e 60 al minuto. Due stream aperti occupano già entrambi gli slot.
Una chiave errata produce tipicamente un errore di autenticazione piuttosto che una risposta del modello. Un limite produce HTTP 429 con il codice rate_limited o concurrency. Leggere il corpo dell'errore, non solo il codice di stato, fa risparmiare tempo perché il codice ti dice quale limite hai raggiunto. Ogni risposta porta un X-Request-Id; tienilo nei tuoi log, così puoi abbinare una chiamata fallita a una richiesta specifica in seguito.
Limiti della prova e cosa offre la prova
Una chiave di prova ha limiti inferiori rispetto a una completa: 2 richieste parallele e 60 richieste al minuto. Una chiave completa consente 8 richieste parallele e 300 richieste al minuto. Per testare una singola persona è più che sufficiente. Se esegui più chat contemporaneamente da uno script di test, vedrai HTTP 429 con il codice di errore concurrency o rate_limited. Una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream, quindi due stream aperti su una chiave di prova lo riempiono.
Fino a dove arriva $0,50? I prezzi sono $0,15 per 1M di token di input e $0,50 per 1M di token di output. Prendi un turno di chat tipico con 1.500 token di cronologia e persona in input e 300 token in output:
- Input: 1.500 token x $0,15 / 1.000.000 = $0,000225
- Output: 300 token x $0,50 / 1.000.000 = $0,00015
- Un turno: $0,000375
- $0,50 / $0,000375 sono circa 1.333 turni
Questo è sufficiente per testare correttamente diversi personaggi. Le richieste fallite o rifiutate non vengono addebitate, quindi una richiesta che genera un errore non consuma il tuo credito. Il credito di prova scade dopo 7 giorni; il credito che acquisti in seguito non scade.
Impostazioni per dare il tono giusto a un personaggio
La chiave ti permette di stabilire la connessione; la qualità di un personaggio deriva dal prompt e dalle impostazioni di campionamento. Alcune abitudini aiutano più di trucchi elaborati.
Scrivi il messaggio di sistema come una breve scheda del personaggio in frasi semplici: chi è il personaggio, come parla, cosa vuole e quanto dovrebbero essere lunghe le sue risposte. Fornisci una o due righe di esempio se la voce è importante. I modelli seguono meglio esempi concreti che aggettivi, quindi una riga come "Mara risponde con frasi brevi e asciutte e fa battute quando è nervosa" funziona meglio di "Mara è spiritosa e affascinante".
Usa temperature per impostare la vivacità. Valori vicini a 0.9 danno una fraseggiatura più varia, mentre valori vicini a 0.5 mantengono il personaggio più stabile. Aggiungi una sequenza stop se la tua app usa un'etichetta parlante come "User:" e vuoi impedire al modello di scrivere l'altra parte della conversazione. Le penalità di frequenza e presenza possono ridurre le frasi ripetute nelle chat lunghe, ma aumentale con cautela, poiché valori elevati possono rendere il dialogo strano.
Ricorda che il modello conosce solo ciò che è nella richiesta. Se il personaggio dovrebbe ricordare il nome del giocatore da 200 messaggi fa, mantieni quel messaggio nella finestra di contesto o memorizza i fatti chiave nel messaggio di sistema. Ecco perché un elenco di memoria che aggiorni tu stesso spesso batte l'invio di una cronologia enorme.
Ricaricare quando il credito di prova si esaurisce
Non c'è abbonamento. Paghi in anticipo e spendi per token. Le ricariche accettano qualsiasi importo intero da $20 a $500, e importi maggiori hanno un bonus: +5% da $50, +10% da $100 e +15% da $200. Quindi $50 diventano $52,50 di credito, $100 diventano $110 e $200 diventano $230. Puoi pagare con cripto (USDT su TRC20, USDC su Base).
La pagina dei prezzi ha la tabella completa. Per la pianificazione, lo stesso turno da 1.500 token in input e 300 in output costa $0,000375, quindi $20 coprono circa 53.000 turni di questo tipo. Il roleplay a lungo termine costa di più per turno perché la cronologia cresce, quindi limita quanto ne invii di nuovo. La finestra di contesto è di 100.000 token, prompt più completamento, ma raramente vuoi riempirla.
Mantenere la chiave al sicuro in un'app reale
L'errore più comune con un progetto chat è chiamare l'API direttamente dal codice del browser. Tutto ciò che viene inviato al browser può essere letto da ogni visitatore, inclusa la chiave. Metti un piccolo server tra il tuo front-end e l'API. Il browser parla con la tua route, la tua route aggiunge l'intestazione Authorization: Bearer e inoltra la richiesta.
- Memorizza la chiave in una variabile d'ambiente o in un gestore di segreti, non nel repository.
- Aggiungi una voce
.enva.gitignoreprima del tuo primo commit. - Usa una chiave per ambiente così una perdita in sviluppo non tocca la produzione.
- Monitora l'intestazione
X-Balance-USDper catturare i loop fuori controllo presto. - Riprova su HTTP 429 con una breve attesa. Una risposta di sovraccarico temporaneo include
Retry-After: 5.
I prompt inviati all'API non vengono utilizzati per l'addestramento. Tuttavia, evita di inviare dati che non vorresti memorizzare in un log dalla tua parte. Se vuoi un'analisi più approfondita di ciò che un'API di questo tipo fa e non fa, l'articolo miti e fatti copre i malintesi comuni.