Průvodce integrací API Character AI

Proč vyměnit Character AI za API?

Character AI je pohodlné, ale uzamkne vaše postavy do svého ekosystému. Nemůžete uložit plné kontextové okno, upravit parametry modelu nebo zajistit soukromí vašich dat. Řešení API jako uncutly AI poskytuje vám přímý přístup k LLM bez omezení. Řídíte prompty, teplotu a sekvence zastavení. To znamená, že se vaše postavy chovají přesně tak, jak chcete.

Proprietární platformy často odmítají obsah, který je zcela legální. Mohou přerušit příběh kvůli citlivému klíčovému slovu. S uncensored chatbot API si určujete, co je povoleno. Získáte jeden spolehlivý endpoint pro generování textu. Tato spolehlivost je klíčová, když stavíte produkt, který závisí na konzistentním chování postav. Nejste v rukou libovolného týmu pro moderování platformy.

Krok 1: Získejte svůj API klíč

Začněte vytvořením účtu na ovládacím panelu poskytovatele. Můžete se přihlásit pomocí Google nebo použít jednoduchý e-mail a heslo. Telefonní číslo není vyžadováno. Po registraci přejděte do sekce API klíčů. Systém vygeneruje unikátní klíč okamžitě. Zkopírujte tento klíč a bezpečně jej uložte do proměnných prostředí.

Každý požadavek na API musí obsahovat tento klíč v hlavičce. Pokud klíč chybí nebo je neplatný, server vrátí chybu 401. Získáte malý zkušební kredit na otestování integrace před utrácením peněz. Tento zkušební kredit platí sedm dní. Je to dobrý způsob, jak ověřit, že vaše nastavení funguje správně.

Krok 2: Nakonfigurujte Base URL

Většina moderních klientů LLM očekává rozhraní kompatibilní s OpenAI. Potřebujete nastavit své SDK na správnou základní URL. Pro tuto službu je koncový bod https://api.uncutlyai.com/v1. Struktura této URL kopíruje standardní API OpenAI. To znamená, že můžete používat existující knihovny bez větších změn v kódu.

Aktualizujte konfigurační objekt tak, aby obsahoval toto základní URL. Nastavte také API klíč v hlavičce authorization. ID modelu, který budete používat, je jednoduše "uncensored". Tento model je laděn pro méně odmítání a lepší kreativní svobodu. Dobře zvládá dlouhá kontextová okna až do 100,000 tokenů. Tato délka umožňuje hluboké historie postav.

Krok 3: Pošlete své první chatové dokončení

Sestavte požadavek na /v1/chat/completions endpoint. Tělo by mělo obsahovat seznam zpráv. Každá zpráva má roli jako „system“, „user“ nebo „assistant“. Zpráva systému definuje osobitu postavy. Zprávy uživatele řídí konverzaci.

Zde je, jak strukturovat požadavek:

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"}]
  }'

Odeslat tento požadavek a uvidíte, jak model odpovídá. Server zpracuje tokeny a vrátí textové dokončení. Můžete nastavit parametry jako temperature ovlivnit kreativitu. Vyšší hodnoty činí postavu nepředvídatelnější. Nižší hodnoty ji činí konzistentnější. Tato flexibilita vám umožňuje doladit hlas.

Krok 4: Zvládněte streamované odpovědi

Chatové aplikace působí pomalu, pokud čeká na celý odpověď až na konci. Streamování toto řeší. Nastavte stream parameter na true. Server odesílá zpět řadu událostí Server-Sent Events (SSE). Každá událost obsahuje malou část textu.

Váš klientský kód musí tyto bloky parsovat a zobrazovat je v reálném čase. To vytváří iluzi psaní člověka. Výrazně to zlepšuje uživatelský zážitek. Poslední blok často obsahuje statistiky využití tokenů. Tato data můžete použít k přesnému sledování nákladů.

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)

Ujistěte se, že váš handler streamování zachytí všechny síťové chyby. Přerušený stream může ponechat uživatelské rozhraní ve stavu načítání. Vždy ukončete spojení, když stream skončí nebo selže.

Krok 5: Řídit tokeny a náklady

Pochopení nákladů na tokeny je zásadní pro plánování rozpočtu. Platíte za milion tokenů. Vstupní tokeny stojí $0.15 za milion. Výstupní tokeny stojí $0.50 za milion. Platíte pouze za tokeny, které jsou zpracovány. Chyby vás nestojí nic. Odmítnutí vás také nestojí nic.

Tento předplacený model je transparentní. Účet si dobíte kryptoměnou. Minimální dobíjení je 20 $. Můžete přidat částku 500 $ najednou. Nejsou zde žádná měsíční předplatná. Váš kredit nevyprší. Tato předvídatelnost vám pomůže plánovat náklady na vývoj. Víte přesně, kolik bude každá konverzace stát.

Krok 6: Implementovat volání funkcí

Pokročilé postavy často potřebují interagovat s externími nástroji. Volání funkcí umožňuje modelu vrátit strukturovaná data. Definujete schéma pro funkci. Model se rozhodne, kdy ji zavolat na základě konverzace.

Například postava může potřebovat zkontrolovat počasí. Pošlete definici funkce v požadavku. Model odpovdí objektem JSON obsahujícím název funkce a argumenty. Váš kód funkci vykoná a výsledek odešle zpět modelu.

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);

Tento cyklus pokračuje, dokud model nevygeneruje finální textovou odpověď. Umožňuje dynamické, interaktivní příběhy. Nejste omezeni na statické textové výstupy. Model může spouštět události ve vaší aplikaci.

Krok 7: Zpracování chyb a limity

API mají limity. Můžete odeslat 300 požadavků za minutu. Současně může být aktivních pouze osm požadavků. Tělo požadavku musí být menší než 8 MB. Pokud tyto limity překročíte, obdržíte chybu 429. Do logiky opakování implementujte exponenciální zpětné zpoždění.

Zvládněte síťové chyby elegantně. Pokud server vrátí chybu 500, počkejte a zkuste to znovu. Nikdy předpokládejte, že model vždy uspěje. Logujte tyto chyby pro identifikaci vzorců. Časté časové limity mohou naznačovat, že potřebujete upravit nastavení časového limitu.

Krok 8: Škálovat vaši integraci

Jak roste vaše uživatelská základna, bude růst i vaše používání API. Sledujte spotřebu tokenů úzce. Použijte data o používání ze streamovacích odpovědí k sledování nákladů. Pokud si všimnete vysokých nákladů, zvažte optimalizaci vašich promptů. Kratší systémové prompty mohou snížit vstupní tokeny.

Zvažte ukládání častých odpovědí do mezipaměti. Pokud se více uživatelů ptá na stejnou otázku, sloužte uložený výsledek. To sníží počet volání API a ušetří peníze. Na vlastním serveru můžete také implementovat omezení rychlosti (rate limiting). Zabráníte tak tomu, aby jeden uživatel spotřeboval veškerý váš kredit. Dobře škálovaná integrace zůstává rychlá a spolehlivá.