Character AI API-sleutel: hoe je er een krijgt en gebruikt
Als je zocht naar een character ai API-sleutel, is het eerste dat je moet weten dat deze site niet Character.ai is en geen sleutels van hen uitgeeft. Het geeft je een sleutel voor een onafhankelijke, OpenAI-compatible text API die werkt als drop-in backend voor character chat apps.
Bijgewerkt

Belangrijkste punten
- Je krijgt een sleutel na het registreren met Google of e-mail en wachtwoord, en het openen van de API-sleutelpagina.
- Nieuwe gebruikers kunnen met één klik $0,50 aan gratis proeftegoed claimen, zonder creditcard, geldig voor 7 dagen.
- Gebruik de base URL https://api.characteraiapi.com/v1 en de model ID
uncensoredmet elke OpenAI SDK. - Bewaar de sleutel op een server of in een environment variable, nooit in publieke front-end code.
Wat je precies krijgt
Character.ai is een consumenten chatproduct. Mensen die naar een character ai api-sleutel zoeken, willen meestal een van twee dingen: een manier om een character chatbot aan te roepen vanuit hun eigen code, of een backend voor een persona-app die niet beperkt wordt door de regels van een gehoste dienst. Deze site dekt de tweede behoefte. Je registreert je, ontvangt een sleutel en stuurt verzoeken naar een OpenAI-compatible endpoint. Niets hier verbindt met Character.ai of hergebruikt zijn karakters.
De dienst is een gehoste tekst-API voor één open-weight model, gerund door een onafhankelijke provider en afgestemd op antwoorden zonder content refusals voor legaal gebruik door volwassenen. Het is niet de officiële API van een modelvendor en geen router tussen vendors. De model ID is uncensored, en de base URL is https://api.characteraiapi.com/v1. Er zijn twee methoden: POST /v1/chat/completions en GET /v1/models.
Omdat de interface overeenkomt met die van OpenAI, ligt het werk aan het bouwen van een character aan jouw kant. Je schrijft de persona als een system message, bewaart de conversation history en stuurt dit met elk verzoek. Dat geeft je controle over stem, geheugen en tempo die een gesloten product zelden blootgeeft. De harde limiet is voor elke gebruiker hetzelfde: geen seksuele content met minderjarigen, ooit.
Haal je sleutel in vijf stappen
Het hele proces duurt een paar minuten. Je hebt geen creditcard nodig om te beginnen.
- Registreer. Gebruik Google, of registreer met een e-mail en wachtwoord.
- Open de sleutelpagina. Ga naar de API-sleutelpagina, waar de sleutel van je account wordt getoond.
- Claim het proeftegoed. Één klik op die pagina voegt $0,50 aan gratis proeftegoed toe. Het is beperkt tot één per persoon en is 7 dagen geldig.
- Kopieer de sleutel. Sla hem direct op in een wachtwoordbeheerder of een secrets bestand.
- Stuur een testverzoek. Gebruik de onderstaande curl opdracht voordat je app-code aanraakt.
Behandel de sleutel als een wachtwoord. Iedereen die hem heeft, kan je saldo uitgeven. Als je denkt dat hij gelekt is, stop dan direct met het gebruik, verwijder hem uit elke app en controleer je saldo op onverwachte uitgaven.
Test de sleutel met curl
Stel de sleutel in als een environment variable zodat deze niet als platte tekst in je shell history terechtkomt binnen een script. Lijst vervolgens de modellen op. Dit bevestigt dat de sleutel werkt en dat je de juiste host bereikt.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Je zou een JSON-lijst moeten krijgen die uncensored bevat. Stuur nu een eerste chatverzoek met een kleine persona. De system message stelt het karakter in, de user message begint de scène.
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
}'De respons volgt de standaard chat completions structuur. De reply tekst staat in choices[0].message.content. De response headers bevatten ook X-Request-Id, X-Balance-USD en de rate limit headers, wat handig is als je een resterend saldo in je eigen UI wilt tonen.
Gebruik de sleutel vanuit Python of Node
Elke OpenAI SDK werkt zodra je twee waarden aanpast: de base URL en de sleutel. Hier is de Python-versie met het officiële openai package.
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)En dezelfde call 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);Veel chat front-ends hebben een veld voor een aangepast OpenAI-compatible endpoint. In die tools plak je de base URL, plak je de sleutel en typ je uncensored als de modelnaam. Er hoeft niets anders te veranderen. De docs-pagina vermeldt de ondersteunde parameters, waaronder streaming, tool calling en JSON mode.
Veelvoorkomende sleutelproblemen en snelle oplossingen
De meeste fouten van de eerste keer komen door een handvol kleine fouten. Controleer ze in deze volgorde voordat je iets groots vermoedt.
- Extra spaties of aanhalingstekens in de sleutel. Een trailing newline die uit een bestand wordt gekopieerd, is genoeg om authenticatie te laten falen. Print de lengte van de variable en vergelijk deze met wat je hebt gekopieerd.
- Verkeerde base URL. De base URL eindigt op
/v1, en de SDK voegt zelf/chat/completionstoe. Als je ook/chat/completionsaan de base URL toevoegt, wordt het pad verdubbeld en faalt het verzoek. - Verkeerde modelnaam. De model ID is
uncensored. Namen van andere diensten komen niet overeen. RoepGET /v1/modelsaan om te zien wat de server rapporteert. - Ontbrekende header. Ruwe HTTP calls hebben
Authorization: Bearergevolgd door een spatie en de sleutel nodig, plusContent-Type: application/jsonop POST requests. - Leeg saldo. De
X-Balance-USDresponse header toont wat er nog over is. Als het gratis proeftegoed op is of na 7 dagen verloopt, moet je opwaarderen of zullen verzoeken falen. - Rate limits. Een trial key staat 2 gelijktijdige verzoeken en 60 per minuut toe. Twee open streams gebruiken al beide slots.
Een slechte sleutel levert meestal een authentication error op in plaats van een model reply. Een limit geeft HTTP 429 met de code rate_limited of concurrency. Het lezen van de error body, niet alleen de status code, bespaart tijd omdat de code je vertelt welke limit je raakte. Elke response draagt een X-Request-Id; bewaar het in je logs, zodat je een mislukte call later kunt matchen aan een specifiek verzoek.
Proeflimieten en wat het proeftegoed dekt
Een trial key heeft lagere limits dan een volledige: 2 gelijktijdige verzoeken en 60 verzoeken per minuut. Een volledige key staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Voor het testen van een enkele persona is dat meer dan genoeg. Als je meerdere chats tegelijk uitvoert vanuit een test script, zie je HTTP 429 met de error code concurrency of rate_limited. Een gestreamd verzoek houdt zijn concurrency slot vast tot de stream eindigt, dus twee open streams op een trial key vullen het.
Hoe ver gaat $0,50? Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens. Neem een typische chat turn met 1.500 tokens van history en persona die ingaan en 300 tokens die eruit komen:
- Input: 1.500 tokens x $0,15 / 1.000.000 = $0,000225
- Output: 300 tokens x $0,50 / 1.000.000 = $0,00015
- Eén turn: $0,000375
- $0,50 / $0,000375 is ongeveer 1.333 turns
Dat is genoeg om meerdere characters goed te testen. Mislukte of geweigerde verzoeken worden niet aangerekend, dus een verzoek dat een error geeft, verbruikt je credit niet. De trial verloopt na 7 dagen; credit dat je later koopt, verloopt niet.
Instellingen die een persona natuurlijk laten aanvoelen
Een sleutel geeft je de verbinding; de kwaliteit van een character komt van de prompt en de sampling settings. Een paar gewoontes helpen meer dan slimme trucjes.
Schrijf de system message als een kort character sheet in gewone zinnen: wie het character is, hoe het praat, wat het wil, en hoe lang zijn replies moeten zijn. Geef één of twee voorbeeldregels dialoog als de stem belangrijk is. Modellen volgen concrete voorbeelden beter dan adjectieven, dus een regel zoals "Mara antwoordt in korte, droge zinnen en grapt als ze zenuwachtig is" werkt beter dan "Mara is grappig en charmant".
Gebruik temperature om de levendigheid in te stellen. Waarden rond 0,9 geven meer gevarieerde formuleringen, terwijl waarden rond 0,5 het personage stabieler houden. Voeg een stop-sequentie toe als je applicatie een spreeklabel gebruikt zoals "Gebruiker:" en je wilt voorkomen dat het model de andere kant van het gesprek schrijft. De frequentie- en aanwezigheidsstraf kunnen herhaalde zinnen in lange chats verminderen, maar verhoog ze voorzichtig, want hoge waarden kunnen de dialoog vreemd maken.
Onthoud dat het model alleen weet wat in het verzoek staat. Als het character de naam van de speler uit 200 berichten geleden moet onthouden, houd dat bericht dan in het venster of sla belangrijke feiten op in de system message. Dit is waarom een geheugenlijst die je zelf bijwerkt vaak beter werkt dan het sturen van een enorme history.
Je tegoed opwaarderen als het proeftegoed op is
Er is geen abonnement. Je betaalt vooraf en gebruikt tegoed per token. Je kunt opwaarderen met elk geheel bedrag van $20 tot $500, en hogere bedragen hebben een bonus: +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Dus $50 wordt $52,50 aan tegoed, $100 wordt $110 en $200 wordt $230. Je kunt alleen betalen met crypto (USDT op TRC20, USDC op Base).
De prijzenpagina heeft de volledige tabel. Voor planning kost dezelfde turn van 1.500-in, 300-uit $0,000375, dus $20 dekt ongeveer 53.000 van zulke turns. Langdurige roleplay kost meer per turn omdat de history groeit, dus beperk hoeveel je ervan opnieuw stuurt. Het contextvenster is 100.000 tokens, prompt plus completion, maar je wilt het zelden vullen.
De sleutel veilig bewaren in een echte applicatie
De meest voorkomende fout bij een chatproject is de API rechtstreeks aanroepen vanuit browsercode. Alles wat naar de browser wordt gestuurd, kan door elke bezoeker worden gelezen, inclusief de sleutel. Plaats een kleine server tussen je front-end en de API. De browser communiceert met je route, je route voegt de Authorization: Bearer header toe en stuurt het verzoek door.
- Bewaar de sleutel in een environment variable of een secrets manager, niet in de repository.
- Voeg een
.env-regel toe aan.gitignorevoordat je je eerste commit maakt. - Gebruik één sleutel per omgeving, zodat een lek in de ontwikkeling geen invloed heeft op de productie.
- Houd de
X-Balance-USDheader in de gaten om uit de hand lopende loops vroeg te detecteren. - Probeer opnieuw bij HTTP 429 met een korte wachttijd. Een tijdelijk overload-antwoord bevat
Retry-After: 5.
Prompts die naar de API worden gestuurd, worden niet gebruikt voor training. Vermijd desondanks het versturen van gegevens die je niet in een log aan je eigen kant zou willen opslaan. Als je dieper wilt kijken naar wat zo'n API wel en niet doet, behandelt het mythes en feiten artikel veelvoorkomende misverstanden.