Character AI:n integraatio-opas

Miksi korvata Character AI API:lla?

Character AI on kätevä, mutta se lukitsee hahmosi sen ekosysteemiin. Et voi tallentaa koko kontekstiikkunaa, säätää mallin parametreja tai varmistaa tietjesi yksityisyyttä. API-ratkaisu kuten uncutly AI antaa sinulle suoran pääsyn sensuroimattomaan LLM:ään. Hallitset prompteja, lämpötilaa ja stop-sekvenssejä. Tämä tarkoittaa, että hahmosi käyttäytyvät täsmälleen niin kuin haluat niiden tekevän.

Proprietääriset alustat hylkäävät usein sisältöä, joka on täysin laillista. Ne voivat katkaista tarinan herkän avainsanan vuoksi. Uncensored-chatbot-API:lla sinä päätät, mikä on sallittua. Saat yhden, luotettavan päätepisteen tekstigenerointiin. Tämä luotettavuus on kriittistä, kun rakennat tuotetta, joka riippuu johdonmukaisesta hahmokäyttäytymisestä. Et ole alustan mielivaltaisen moderointitiimin armoilla.

Vaihe 1: Hanki API-avaimesi

Aloita luomalla tili palveluntarjoajan hallintapaneelissa. Voit kirjautua sisään Google-tilillä tai käyttää yksinkertaista sähköpostiosoitetta ja salasanaa. Puhelinnumeroa ei tarvita. Rekisteröitymisen jälkeen siirry API-avain-osioon. Järjestelmä luo ainutlaatuisen avaimen välittömästi. Kopioi tämä avain ja säilytä se turvallisesti ympäristömuuttujissasi.

Jokaisen pyynnön API:lle on sisällettävä tämä avain headerissa. Jos avain puuttuu tai on virheellinen, palvelin palauttaa 401-virheen. Saat pienen kokeilukreditin testataksesi integraatiota ennen rahojen käyttämistä. Tämä kokeilukrediitti kestää 7 päivää. Se on hyvä tapa varmistaa, että asetuksesi toimivat oikein.

Vaihe 2: Määritä base URL

Useimmat nykyaikaiset LLM-asiakasohjelmat odottavat OpenAI-yhteensopivaa käyttöliittymää. Sinun täytyy osoittaa SDK:si oikeaan base URL -arvoon. Tälle palvelulle päätepiste on https://api.uncutlyai.com/v1. Tämä URL-rakenne vastaa standardia OpenAI-APIa. Tämä tarkoittaa, että voit käyttää olemassa olevia kirjastoja ilman merkittäviä koodimuutoksia.

Päivitä määritysobjekti sisällyttämään tämä base URL. Aseta myös API-avain authorization-otsikkoon. Käyttämäsi mallin tunnus on yksinkertaisesti "uncensored". Tämä malli on hienosäädetty vähentämään kieltäytymisiä ja parantamaan luovuutta. Se käsittelee hyvin pitkiä konteksteja, jopa 100 000 tokeniä. Tämä pituus mahdollistaa syvälliset hahmohistoriat.

Vaihe 3: Lähetä ensimmäinen chat-päättöpyyntö

Rakenna pyyntö osoitteeseen /v1/chat/completions päätepiste. Rungon tulisi sisältää luettelon viestejä. Jokaisella viestillä on rooli kuten "system" (järjestelmä), "user" (käyttäjä) tai "assistant" (avustaja). Järjestelmäviesti määrittää hahmon persoonallisuuden. Käyttäjäviestit ohjaavat keskustelua.

Tässä kerrotaan, miten rakennat pyynnön:

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

Lähetä tämä pyyntö nähdäksesi mallin vastaavan. Palvelin käsittelee merkit ja palauttaa tekstitäydennyksen. Voit asettaa parametreja kuten temperature hallita luovuutta. Korkeammat arvot tekevät hahmosta ennustamattomamman. Matalammat arvot tekevät siitä johdonmukaisemman. Tämä joustavuus mahdollistaa äänen hienosäädön.

Vaihe 4: Käsittele suoratoistovastauksia

Chat applications feel sluggish if the entire response waits until the end. Streaming solves this. Set the stream parametri arvoon true. Palvelin palauttaa joukon Server-Sent Events (SSE) -tapahtumia. Jokainen tapahtuma sisältää pienen tekstiosan.

Asiakaskoodisi on jäsennettävä nämä palat ja näytettävä ne reaaliajassa. Tämä luo ihmisen kirjoittamisen illuusion. Se parentaa merkittävästi käyttäjäkokemusta. Viimeinen pala sisältää usein token-käystilastot. Voit käyttää tätä dataa kustannusten tarkkaan seurantaan.

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)

Varmista, että stream-käsittelijäsi nappaa kaikki verkkovirheet. Katkennut stream voi jättää käyttöliittymän lataustilaan. Sulje aina yhteys, kun stream päättyy tai epäonnistuu.

Vaihe 5: Hallitse token-määrää ja kustannuksia

Token-kustannusten ymmärtäminen on välttämätöntä budjetointia varten. Maksat miljoonan tokenin perusteella. Syöttötokenit maksavat $0,15 miljoonaa kohti. Tulostokenit maksavat $0,50 miljoonaa kohti. Maksat vain käsitellyistä tokenneista. Virheet eivät veloita sinulta. Kieltäytymiset eivät myöskään veloita.

Tämä esimaksumalli on läpinäkyvä. Lisäät rahaa kryptorahalla. Minimilisäys on 20 $. Voit lisätä 500 $ kerralla. Ei kuukausitilauksia. Krediitti ei vanhene. Tämä ennustettavuus auttaa sinua suunnittelemaan kehityskustannuksiasi. Tiedät tarkalleen, kuinka paljon jokainen keskustelu maksaa.

Vaihe 6: Toteuta funktiokutsut

Edistyneet hahmot tarvitsevat usein vuorovaikutusta ulkoisten työkalujen kanssa. Funktion kutsuminen mahdollistaa mallin palauttaa rakenteellista dataa. Määrittelet funktion skeeman. Malli päättää, milloin sitä kutsutaan keskustelun perusteella.

Esimerkiksi hahmon on tarkistettava sää. Lähetät funktiomäärittelyn pyynnössä. Malli vastaa JSON-objektilla, joka sisältää funktion nimen ja argumentit. Koodisi suorittaa funktion ja lähettää tuloksen takaisin mallille.

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

Tämä silmukka jatkuu, kunnes malli tuottaa lopullisen tekstimäärityksen. Se mahdollistaa dynaamiset, interaktiiviset tarinat. Et ole rajoittunut staattisiin tekstituloksiin. Malli voi laukaista tapahtumia sovelluksessasi.

Vaihe 7: Virheenkäsittely ja rajoitukset

API:illa on rajoituksia. Voit lähettää 300 pyyntöä minuutissa. Vain kahdeksan pyyntöä voi olla aktiivisia samanaikaisesti. Pyyntöruumiin on oltava alle 8 Mt. Jos ylität nämä rajat, saat 429-virheen. Toteuta eksponentiaalinen taaksepäin siirtyminen uudelleenyrittämislogiikkaasi.

Käsittele verkkovirheet joustavasti. Jos palvelin palauttaa 500-virheen, odota ja yritä uudelleen. Älä oleta, että malli on aina onnistuva. Lokita nämä virheet kuvioiden tunnistamiseksi. Tiheät aikakatkaisut voivat viitata siihen, että sinun tulee säätää aikakatkaisujasi.

Vaihe 8: Skaalaa integraatiotasi

Käyttäjäkantasi kasvaessa API-käyttösi kasvaa. Seuraa tokenien kulutusta tarkasti. Käytä streamausvastauksista saatua käyttödataa kustannusten seurantaan. Jos huomaat korkeita kustannuksia, harkitse promptiesi optimointia. Lyhyemmät järjestelmäpromptit voivat vähentää syötetokenneja.

Harkitse usein käytettyjen vastausten välimuistia. Jos useat käyttäjät kysyvät samaa kysymystä, palauta välimuistitettu tulos. Tämä vähentää API-pyyntöjä ja säästää rahaa. Voit myös toteuttaa nopeusrajoituksen omalle palvelimellesi. Tämä estää yksittäistä käyttäjää kuluttamasta koko luottotiliäsi. Hyvin skaalattu integraatio pysyy nopeana ja luotettavana.