Integrare Rapidă API Character
Acest ghid rapid face ca API-ul tău de personaje să funcționeze cu SDK-urile standard OpenAI în câteva minute. Vei configura URL-ul de bază, vei injecta cheia API și vei trimite prima cerere nelimitată.
Instalează SDK-ul
Începe prin a instala biblioteca client oficială pentru limbajul tău. Acest lucru asigură compatibilitatea cu endpoint-ul compatibil cu OpenAI pe care îl oferim. Biblioteca se ocupă de serializare și logica de reîncercare pentru tine.
Pentru Python, folosește pip. Pentru Node.js, folosește npm. Acest pas durează câteva secunde și configurează mediul pentru mostrele de cod care urmează.
Configurați URL-ul de bază
Indreptați clientul SDK către endpoint-ul nostru pentru a accesa modelul fără cenzură. URL-ul de bază este HTTPS://api.apicharacter.com/v1. Acesta înlocuiește URL-ul implicit OpenAI în configurația dumneavoastră.
Fără această modificare, solicitările vor eșua sau vor ajunge la serviciul greșit. Trebuie să setezi acest lucru o singură dată când inițializezi instanța clientului.
Setează-ți cheia API
Injectează cheia ta în variabila de mediu sau în configurația clientului. Autentificarea este necesară pentru fiecare cerere pentru a urmări utilizarea creditelor preplătite. Cheia ta oferă acces la endpoint-ul LLM uncensored.
Păstrați această valoare în siguranță. Aceasta acționează ca singura dumneavoastră acreditare pentru cont. Nu este nevoie de număr de telefon sau verificare suplimentară pentru accesul de bază.
Fă prima ta solicitare
Trimiteți o completare chat simplă pentru a verifica conectivitatea. ID-ul modelului este "uncensored". Acest lucru confirmă că autentificarea și URL-ul de bază sunt corecte înainte de a vă construi aplicația.
Vezi exemplul de mai jos pentru o cerere cURL standard.
curl https://api.apicharacter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "set my name to Alex"}]
}'
Gestionați răspunsurile de streaming
Activați streaming-ul pentru latență redusă în interfețele tale de chat. Setează parametrul stream la true în solicitarea ta. SDK-ul va genera tokenii pe măsură ce sunt generați.
Aceasta este critică pentru experiențele utilizatorului responsive. Gestionezi chunk-urile parțiale pe măsură ce sosesc prin Server-Sent Events.
stream = 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)
Limitări, Erori și Context
Înțelegeți constrângerile pentru a evita întreruperile serviciului. Aveți o fereastră de context de 100.000 de tokeni. Ieșirea maximă este de 16.000 de tokeni, decât dacă specificați altfel.
Limita de rată este de 300 de cereri pe minut. O eroare 401 înseamnă cheie invalidă. O eroare 402 înseamnă credit zero. O eroare 429 înseamnă că ai atins limita de rată. Ține cont de acestea pentru scalarea în producție.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.apicharacter.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apicharacter.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);Întrebări frecvente
Cum obțin cheia mea API pentru personaje?
Înregistrează-te cu Google sau cu email pe dashboard. Cheia API apare imediat, fără verificare telefonică. Poți genera o cheie nouă dacă este nevoie, înlocuind pe cea veche.
Este un API compatibil cu openai?
Da, urmează formatul standard chat-completions. Trebuie doar să schimbi URL-ul de bază și cheia API. Majoritatea SDK-urilor OpenAI funcționează din start cu modificări minore de configurare.
Ce se întâmplă dacă primesc o eroare 402?
Înseamnă că creditul tău preplătit s-a epuizat. Reîncarcă prin criptomonede pentru a relua serviciul. Erorile și refuzurile nu consumă credit, așa că plătești doar pentru utilizarea reală.
Obțineți cheia instant
Înregistrează-te, obține cheia și actualizează URL-ul de bază. Așa e.