Character api Integration Quickstart

Installer SDK

Start med at installere det officielle klientbibliotek til dit sprog. Dette sikrer kompatibilitet med det OpenAI-kompatible endpoint, vi tilbyder. Biblioteket håndterer serialisering og gentagelseslogik for dig.

Til Python skal du bruge pip. Til Node.js skal du bruge npm. Dette trin tager sekunder og opsætter miljøet til kodeeksemplerne, der følger.

Konfigurer din base URL

Peg din SDK-klient på vores endpoint for at få adgang til den ubegrænsede model. Base URL'en er HTTPS://api.apicharacter.com/v1. Dette erstatter standard OpenAI-URL'en i din konfiguration.

Uden denne ændring vil anmodninger mislykkes eller ramme den forkerte tjeneste. Du skal kun indstille dette én gang, når du initialiserer din klientinstans.

Indstil din API-nøgle

Indsæt din nøgle i miljøvariablen eller klientkonfigurationen. Autentificering er påkrævet for hvert request for at spore dit forudbetalt kreditforbrug. Din nøgle giver adgang til uncensored LLM-endpointet.

Hold denne værdi sikker. Den fungerer som dit eneste legitimationsbevis for kontoen. Intet telefonnummer eller yderligere verifikation er nødvendigt for grundlæggende adgang.

Lav din første anmodning

Send en simpel chat-completion for at verificere forbindelsen. Model-ID er "uncensored". Dette bekræfter, at din autentificering og base URL er korrekte, før du bygger din applikation.

Se eksemplet nedenfor for en standard cURL-anmodning.

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

Håndter Streaming-respons

Aktivér streaming for lavere forsinkelse i dine chatgrænseflader. Indstil stream-parameteren til true i din anmodning. SDK'et vil udstede tokens, mens de genereres.

Dette er kritisk for responsive brugeroplevelser. Du håndterer de delvise chunks, mens de ankommer 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)

Begrænsninger, fejl og kontekst

Forstå dine begrænsninger for at undgå tjenesteaflad. Du får et kontekstvindue på 100.000 tokens. Max output er 16.000 tokens, medmindre du angiver andet.

Rate limit er 300 anmodninger i minuttet. En 401-fejl betyder ugyldig nøgle. En 402 betyder nul kredit. En 429 betyder, at du har ramt rate limitet. Husk disse for produktionsskalering.

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