Korte Startgids voor Character api Integratie

Installeer de SDK

Installeer eerst de officiële clientbibliotheek voor je taal. Dit zorgt voor compatibiliteit met het OpenAI-compatibele eindpunt dat we aanbieden. De bibliotheek verzorgt serialisatie en retry-logica voor je.

Voor Python gebruik je pip. Voor Node.js gebruik je npm. Deze stap duurt enkele seconden en stelt de omgeving in voor de codevoorbeelden die volgen.

Configureer je Base URL

Wijs uw SDK-client naar ons eindpunt om toegang te krijgen tot het ongefilterde model. De basis-URL is HTTPS://api.apicharacter.com/v1. Dit vervangt de standaard OpenAI-URL in uw configuratie.

Zonder deze wijziging zullen verzoeken falen of de verkeerde service raken. Je hoeft dit slechts één keer in te stellen bij het initialiseren van je client-instantie.

Je API-sleutel instellen

Injecteer je sleutel in de omgevingsvariabele of clientconfiguratie. Authenticatie is vereist voor elk verzoek om je voorgekochte creditgebruik bij te houden. Je sleutel geeft toegang tot het uncensored LLM-eindpunt.

Bewaar deze waarde veilig. Het fungeert als uw enige referentie voor het account. Er is geen telefoonnummer of extra verificatie nodig voor basis toegang.

Maak je eerste verzoek

Stuur een eenvoudige chatcompletion om de connectiviteit te verifiëren. De model-ID is "uncensored". Dit bevestigt dat je authenticatie en basis-URL correct zijn voordat je je applicatie bouwt.

Bekijk het onderstaande voorbeeld voor een standaard cURL-verzoek.

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

Afhandelen van Streamingresponsen

Schakel streaming in voor lagere latentie in je chatinterfaces. Stel de stream-parameter in op true in je verzoek. De SDK zal tokens opleveren zodra ze worden gegenereerd.

Dit is cruciaal voor responsieve gebruikerservaringen. Je verwerkt de gedeeltelijke chunks naarmate ze aankomen via Server-Sent Events.

Copystream = 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)

Limieten, fouten en context

Begrijp je beperkingen om serviceonderbrekingen te voorkomen. Je krijgt een contextvenster van 100.000 tokens. Max output is 16.000 tokens tenzij je anders specificeert.

Rate limit is 300 requests per minute. A 401 error means invalid key. A 402 means zero credit. A 429 means you hit the rate limit. Keep these in mind for production scaling.

Python

Copyfrom 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

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