Character AI API: Wissel je client in drie regels uit

Vereisten

Voordat je code schrijft, heb je een actief account nodig op characteraiapi.com. Bezoek de API-sleutel ophalen pagina en meld je aan met alleen een e-mailadres en wachtwoord. Er is geen creditcard nodig om te beginnen, en nieuwe accounts ontvangen $0,50 aan gratis proeftegoed geldig voor 7 dagen. Zodra je bent geregistreerd, wordt je API-sleutel direct weergegeven. Bewaar deze sleutel veilig, omdat deze alle verzoeken aan de endpoint verifieert. Je hebt ook een ondersteunde SDK voor de taal nodig geïnstalleerd in je ontwikkelomgeving. De character ai api endpoint accepteert standaard OpenAI-parameters, dus elke bestaande OpenAI-compatible client kan met minimale wijzigingen werken.

Installeer de SDK

Installeer voor Python-projecten het officiële OpenAI-pakket met pip. Deze bibliotheek verwerkt automatisch de JSON-serialisatie en HTTP-verzoeken. Gebruik voor Node.js-applicaties npm om het openai-pakket toe te voegen. Beide bibliotheken ondersteunen de streaming- en tool-calling-functies die later in deze gids worden beschreven. Zorg dat je SDK-versie recent genoeg is om Server-Sent Events (SSE) te ondersteunen voor realtime token-streaming. Als je een aangepaste HTTP-client gebruikt in plaats van een SDK, moet je de JSON-payload en SSE-streamparsing handmatig afhandelen volgens de OpenAI API-specificatie.

Authenticatie

Elk verzoek aan de API moet je API-sleutel bevatten in de Authorization-header. Gebruik het formaat Bearer YOUR_API_KEY. De basis-URL voor alle verzoeken is https://api.characteraiapi.com/v1. Stel bij gebruik van een SDK de configuratie base_url in op deze waarde en lever je sleutel via de parameter api_key. Als je je sleutel kwijtraakt of vermoedt dat deze gelekt is, kun je deze opnieuw genereren via het dashboard; de oude sleutel wordt onmiddellijk ingetrokken. Per account is slechts één actieve sleutel toegestaan. Zorg dat je de juiste basis-URL gebruikt, want verzoeken aan het standaard OpenAI-endpoint zullen falen met een 404- of 401-fout.

Basis chatcompletion

De kernfunctionaliteit wordt aangeboden via het /v1/chat/completions-endpoint. Stuur een POST-verzoek met een modelnaam van uncensored en je berichtgeschiedenis. Het model reageert met tekstuitvoer zonder de standaard inhoudsfilters voor wettelijk volwassen materiaal toe te passen. Hieronder volgt een curl-voorbeeld dat een eenvoudig tekst-aanvullingsverzoek demonstreert.

Copycurl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Dit verzoek retourneert een voltooiingsobject met de gegenereerde tekst. Je kunt parameters aanpassen zoals temperature om willekeurigheid te regelen of max_tokens om de uitvoerlengte te beperken. Het model ondersteunt een contextvenster van 100.000 tokens, waardoor uitgebreide gespreksgeschiedenis of lange documenten in één verzoek kunnen worden verwerkt.

Streamingresponsen

Schakel voor een betere gebruikerservaring streaming in door stream: true in je verzoek in te stellen. De API retourneert Server-Sent Events (SSE) met gedeeltelijke tokenchunks terwijl ze worden gegenereerd. Dit vermindert de waargenomen latentie voor chatbottoepassingen. Gebruik de parameter stream_options als je de laatste gebruikscijfers in het laatste evenement wilt ontvangen. Streaming is met name nuttig voor realtime-personagegesprekken, waarbij het tonen van tekst woord voor woord de immersie verhoogt. Zorg dat je clientcode het SSE-formaat correct afhandelt om elke chunk sequentieel te parseren.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Rate limits en fouten

De API handhaaft een limiet van 300 verzoeken per minuut per sleutel. Als je deze overschrijdt, ontvang je een 429 Too Many Requests-fout. Verzoeklichamen zijn beperkt tot 8 MB. Veelvoorkomende fouten zijn 401 voor een ongeldige of ontbrekende sleutel, en 402 als je prepaid tegoed op is. Je kunt opwaarderen vanaf $10 met crypto (USDT of USDC), met bonus tegoed beschikbaar voor grotere stortingen. In tegenstelling tot sommige providers zijn er geen verborgen kosten of abonnementsvergrendelingen; je betaalt alleen voor de tokens die je verbruikt. Prijzen zijn transparant: $0,25 per 1M invoertokens en $1,00 per 1M uitvoertokens. Zorg dat je foutafhandelingslogica opnieuw probeert bij 429s met exponentiële backoff.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.characteraiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.characteraiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);