Ghid de integrare API Character AI

De ce să înlocuiești Character AI cu un API?

Character AI este convenabil, dar îți blochează personajele în ecosistemul său. Nu poți salva fereastra completă de context, poți ajusta parametrii modelului sau poți asigura confidențialitatea datelor tale. O soluție API precum uncutly AI îți oferă acces direct la un LLM fără cenzură. Tu controlezi prompturile, temperatura și secvențele de oprire. Asta înseamnă că personajele tale se comportă exact așa cum dorești.

Platformele proprietare refuză adesea conținut care este perfect legal. S-ar putea să întrerupă o poveste din cauza unui cuvânt cheie sensibil. Cu un API de chatbot uncensored, tu decizi ce este permis. Primești un singur endpoint fiabil pentru generarea de text. Această fiabilitate este crucială când construiești un produs care depinde de un comportament consistent al personajelor. Nu ești la mila echipei de moderare arbitrară a unei platforme.

Pasul 1: Obține-ți cheia API

Începe prin a crea un cont în panoul de control al furnizorului. Te poți autentifica cu Google sau utilizând un email și o parolă simplă. Nu este necesar un număr de telefon. Odată înregistrat, navighează la secțiunea cheilor API. Sistemul generează o cheie unică instantaneu. Copiază această cheie și stocheaz-o în siguranță în variabilele de mediu.

Fiecare solicitare către API trebuie să includă această cheie în antet. Dacă cheia lipsește sau este invalidă, serverul returnează o eroare 401. Primești un credit de probă mic pentru a testa integrarea înainte de a cheltui bani. Acest credit de probă este valabil timp de 7 zile. Este un mod bun de a verifica dacă configurația dumneavoastră funcționează corect.

Pasul 2: Configurați URL-ul de bază

Majoritatea clienților LLM moderni se așteaptă la o interfață compatibilă cu OpenAI. Trebuie să îți direcționezi SDK-ul către URL-ul de bază corect. Pentru acest serviciu, endpoint-ul este https://api.uncutlyai.com/v1. Structura acestei URL imită API-ul standard OpenAI. Asta înseamnă că poți folosi librăriile existente fără modificări majore de cod.

Actualizați obiectul de configurare pentru a include acest URL de bază. De asemenea, setați cheia API în antetul de autorizare. ID-ul modelului pe care îl veți utiliza este simplu "uncensored". Acest model este optimizat pentru mai puține refuzuri și o libertate creativă mai bună. Gestionează bine contextele lungi, până la 100.000 de tokeni. Această lungime permite istorii de personaje profunde.

Pasul 3: Trimiteți prima solicitare de completări chat

Construiți o solicitare către /v1/chat/completions endpoint. Corpul ar trebui să conțină o listă de mesaje. Fiecare mesaj are un rol precum "system", "user" sau "assistant". Mesajul de sistem definește personalitatea personajului. Mesajele utilizatorului ghidează conversația.

Iată cum structurezi cererea:

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

Trimite această cerere pentru a vedea modelul răspunzând. Serverul procesează tokenii și returnează o completare text. Poți seta parametri precum temperature pentru a controla creativitatea. Valorile mai mari fac personajul mai imprevizibil. Valorile mai mici îl fac mai consistent. Această flexibilitate îți permite să ajustezi fin vocea.

Pasul 4: Gestionați răspunsurile în streaming

Aplicațiile Chat par lente dacă întregul răspuns așteaptă până la final. Streaming-ul rezolvă această problemă. Setează stream parametrul la true. Serverul trimite înapoi o serie de Evenimente trimise de server (SSE). Fiecare eveniment conține un mic fragment de text.

Codul client trebuie să analizeze aceste fragmente și să le afișeze în timp real. Acest lucru creează iluzia unei tastări umane. Îmbunătățește semnificativ experiența utilizatorului. Fragmentul final conține adesea statistici de utilizare a tokenilor. Puteți utiliza aceste date pentru a vă urmări costurile cu precizie.

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)

Asigură-te că handler-ul de streaming prinde orice erori de rețea. Un stream întrerupt poate lăsa interfața utilizatorului într-o stare de încărcare. Închide întotdeauna conexiunea când stream-ul se termină sau eșuează.

Pasul 5: Gestionarea tokenilor și a costurilor

Înțelegerea costurilor pe tokeni este esențială pentru bugetare. Plătiți per milion de tokeni. Tokenii de input costă $0.15 per milion. Tokenii de output costă $0.50 per milion. Plătiți doar pentru tokenii procesați. Erorile nu vă sunt facturate. Refuzurile nu vă sunt facturate nici ele.

Acest model preplătit este transparent. Încărcați soldul cu criptomonede. Încărcarea minimă este de $20. Puteți adăuga $500 odată. Nu există abonamente lunare. Soldul dumneavoastră nu expiră. Această predictibilitate vă ajută să planificați costurile de dezvoltare. Știți exact cât va costa fiecare conversație.

Pasul 6: Implementarea apelării funcțiilor

Personajele avansate au adesea nevoie să interacționeze cu instrumente externe. Apelul de funcții permite modelului să returneze date structurate. Definești un scheamă pentru funcție. Modelul decide când să o apeleze în funcție de conversație.

De exemplu, un personaj ar putea avea nevoie să verifice vremea. Trimite definiția funcției în cerere. Modelul răspunde cu un obiect JSON care conține numele funcției și argumentele. Codul tău execută funcția și trimite rezultatul înapoi la model.

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

Acest ciclu continuă până când modelul generează răspunsul final de text. Permite povești dinamice și interactive. Nu ești limitat la output-uri de text statice. Modelul poate declanșa evenimente în aplicația ta.

Pasul 7: Gestionarea erorilor și a limitelor

API-urile au limite. Poți trimite 300 de cereri pe minut. Doar opt cereri pot fi active simultan. Corpul cererii trebuie să fie sub 8 MB. Dacă depășești aceste limite, primești un error 429. Implementează un backoff exponențial în logica de reîncercare.

Gestionați erorile de rețea în mod elegant. Dacă serverul returnează o eroare 500, așteptați și reîncercați. Nu presupuneți niciodată că modelul va reuși întotdeauna. Logați aceste erori pentru a identifica modelele. Timpurile de așteptare frecvente pot indica faptul că trebuie să ajustați setările de timeout.

Pasul 8: Scalarea integrării tale

Pe măsură ce baza ta de utilizatori crește, utilizarea API-ului tău va crește. Monitorizează consumul de tokeni cu atenție. Folosește datele de utilizare din răspunsurile de streaming pentru a urmări costurile. Dacă observi costuri mari, ia în considerare optimizarea prompturilor tale. Prompturile de sistem mai scurte pot reduce tokenii de intrare.

Luați în considerare stocarea răspunsurilor frecvente. Dacă mai mulți utilizatori pun aceeași întrebare, serviți rezultatul stocat. Acest lucru reduce apelurile API și economisește bani. De asemenea, puteți implementa limitarea ratei pe propriul server. Acest lucru împiedică un singur utilizator să consume tot creditul dvs. O integrare bine scalată rămâne rapidă și fiabilă.