Integrationsguide för Character AI API

Varför ersätta Character AI med ett API?

Character AI är bekvämt, men det låser dina karaktärer i dess ekosystem. Du kan inte spara hela kontextfönstret, justera modellparametrarna eller säkerställa att dina data förblir privata. En API-lösning som uncutly AI ger dig direkt tillgång till en LLM utan censurbegränsningar. Du styr promptarna, temperaturen och stoppsekvenserna. Detta innebär att dina karaktärer beter sig exakt som du vill.

Proprietära plattformar vägrar ofta innehåll som är helt lagligt. De kan klippa av en berättelse på grund av en känslig nyckelord. Med en uncensored chattbot-API bestämmer du vad som är tillåtet. Du får en enda, pålitlig slutpunkt för textgenerering. Denna tillförlitlighet är avgörande när du bygger en produkt som beror på konsekvent beteende hos karaktärer. Du är inte vid nåd av en plattforms godtyckliga modereringsteam.

Steg 1: Hämta din API-nyckel

Börja med att skapa ett konto på leverantörens dashboard. Du kan logga in med Google eller använda ett enkelt e-postadress och lösenord. Inget telefonnummer krävs. När du har registrerat dig, navigera till avsnittet för API-nyckel. Systemet genererar en unik nyckel omedelbart. Kopiera denna nyckel och lagra den säkert i dina miljövariabler.

Varje begäran till API:et måste inkludera denna nyckel i huvudet. Om nyckeln saknas eller är ogiltig returnerar servern ett 401-fel. Du får en liten provkredit för att testa integrationen innan du spenderar pengar. Denna provkredit gäller i 7 dagar. Det är ett bra sätt att verifiera att din installation fungerar korrekt.

Steg 2: Konfigurera bas-URL:en

De flesta moderna LLM-klienter förväntar sig ett OpenAI-kompatibelt gränssnitt. Du behöver peka ditt SDK mot korrekt bas-URL. För denna tjänst är slutpunkten https://api.uncutlyai.com/v1. Denna URL-struktur speglar den standardiserade OpenAI API:et. Det innebär att du kan använda befintliga bibliotek utan större kodändringar.

Uppdatera din konfigurationsobjekt så att det innehåller denna bas-URL. Ställ också in API-nyckeln i auktoriseringsrubriken. Modell-ID:t du kommer att använda är helt enkelt "uncensored". Denna modell är optimerad för färre avslag och bättre kreativ frihet. Den hanterar långa kontexter bra, upp till 100,000 tokens. Denna längd möjliggör djupa karaktärshistorier.

Steg 3: Skicka din första chatkomplettering

Konstruera en förfrågan till /v1/chat/completions endpoint. Kroppen ska innehålla en lista med meddelanden. Varje meddelande har en roll som "system", "user" eller "assistant". Systemmeddelandet definierar karaktärens personlighet. Användarmeddelandena driver konversationen.

Här visas hur du strukturerar begäran:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

Skicka denna förfrågan för att se modellen svara. Servern bearbetar token och returnerar en textkomplettering. Du kan ange parametrar som temperature för att styra kreativitet. Högre värden gör karaktären mer oförutsägbar. Lägre värden gör den mer konsekvent. Denna flexibilitet låter dig finjustera rösten.

Steg 4: Hantera strömningsrespons

Chattapplikationer känns sega om hela svaret väntar tills slutet. Strömning löser detta. Ställ in stream parameter till true. Servern returnerar en serie Server-Sent Events (SSE). Varje händelse innehåller en liten textbit.

Din klientkod måste parsa dessa bitar och visa dem i realtid. Detta skapar illusionen av att en människa skriver. Det förbättrar användarupplevelse avsevärt. Den sista biten innehåller ofta tokenförbrukningsstatistik. Du kan använda denna data för att spåra dina kostnader noggrant.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncutlyai.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)

Se till att din streaming-handler fångar alla nätverksfel. En trasig stream kan lämna UI:t i ett laddningstillstånd. Stäng alltid anslutningen när streamen avslutas eller misslyckas.

Steg 5: Hantera token och kostnader

Att förstå tokenkostnader är avgörande för budgetering. Du betalar per miljon tokens. Inmatningstokens kostar $0,15 per miljon. Utmatningstokens kostar $0,50 per miljon. Du betalar bara för tokens som bearbetas. Fel kostar inget. Avslag kostar heller inget.

Denna förbetalda modell är transparent. Du fyller på med kryptovaluta. Minsta insättning är $20. Du kan lägga till $500 i taget. Det finns inga månadsprenumerationer. Din kredit löper aldrig ut. Denna förutsägbarhet hjälper dig att planera dina utvecklingskostnader. Du vet exakt hur mycket varje konversation kommer att kosta.

Steg 6: Implementera funktionsanrop

Avancerade karaktärer behöver ofta interagera med externa verktyg. Funktionsanrop gör att modellen kan returnera strukturerad data. Du definierar ett schema för funktionen. Modellen bestämmer när den ska anropa den baserat på samtalet.

Till exempel kan en karaktär behöva kontrollera vädret. Du skickar funktionsdefinitionen i begäran. Modellen svarar med ett JSON-objekt som innehåller funktionsnamnet och argumenten. Din kod exekverar funktionen och skickar tillbaka resultatet till modellen.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncutlyai.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);

Denna loop fortsätter tills modellen genererar det slutliga textsvaret. Det möjliggör dynamiska, interaktiva berättelser. Du är inte begränsad till statiska textutdata. Modellen kan trigga händelser i din applikation.

Steg 7: Felhantering och gränser

API:er har gränser. Du kan skicka 300 begäranden per minut. Endast åtta begäranden kan vara aktiva samtidigt. Begärdekroppen måste vara under 8 MB. Om du överskrider dessa gränser får du ett 429-fel. Implementera exponentiell backoff i din omförelogi.

Hantera nätverksfel smidigt. Om servern returnerar ett 500-fel, vänta och försök igen. Antag aldrig att modellen alltid lyckas. Logga dessa fel för att identifiera mönster. Frekventa timeout kan indikera att du behöver justera dina timeout-inställningar.

Steg 8: Skala din integration

När din användarbaser växer kommer din API-användning att öka. Övervaka din tokenförbrukning noga. Använd användningsdata från strömsvaren för att spåra kostnader. Om du märker höga kostnader, överväg att optimera dina prompts. Kortare systemprompter kan minska ingångstokens.

Överväg att cacha frekventa svar. Om flera användare ställer samma fråga, leverera det cachade resultatet. Detta minskar API-anrop och sparar pengar. Du kan också implementera hastighetsbegränsning på din egen server. Detta förhindrar att en enskild användare förbrukar all din kredit. En väl skalad integration förblir snabb och pålitlig.