API-dokumentation til Uncensored Chat-kompletteringer

Hurtigstart: Forbind i Python eller JavaScript

Forbind til API'en ved at opdatere din base-URL og indstille din API-nøgle. Endpointet accepterer standard chat-completion-requests og returnerer tekst. Du behøver ikke at installere custom-biblioteker, hvis du bruger de officielle OpenAI SDK'er, da grænsefladen matcher deres specifikation præcist.

Start med en simpel HTTP-forespørgsel for at verificere forbindelsen. Brug curl-kommandoen nedenfor til at sende en grundlæggende prompt til uncensored model. Erstat YOUR_API_KEY med nøglen genereret på dit dashboard.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Til Python-udviklere er processen næsten identisk. Initialiser klienten med din nøgle og den korrekte base-URL. Dette sikrer, at alle anmodninger dirigeres gennem vores ucensurerede servere, mens kompatibilitet med eksisterende værktøjer opretholdes.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiplayrolebest.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)

JavaScript-brugere kan opnå det samme resultat ved hjælp af Node SDK. Indstil baseURL egenskab til vores endpoint. Denne tilgang giver dig mulighed for at integrere API'et i webservere eller backend-tjenester med minimale kodeændringer.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiplayrolebest.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);

Autentificering og API-nøglehåndtering

Autentificeringen afhænger af en enkelt API-nøgle sendt i headeren. Send denne nøgle i Authorization header til hver anmodning. Hvis nøglen mangler eller er ugyldig, returnerer API'et straks en 401-fejl. Dette sikrer sikker adgang til din forudbetalte kredit.

Generér din nøgle på dashboardet. Nøglen vises én gang ved oprettelse. Gem den sikkert i dine miljøvariabler. Del den ikke offentligt. Hver konto understøtter kun én aktiv nøgle ad gangen. Generering af en ny nøgle ugyldiggør den forrige øjeblikkeligt.

Brug nøglen i dine requests som dette: Authorization: Bearer YOUR_API_KEY. Denne standard header-format fungerer med alle store SDK'er. Hold din nøgle klar til hurtig iteration under udviklingen.

Chat Completions endpoint parametre

Send anmodninger til /v1/chat/completions endpoint. Inkluder din messages-array, og indstil modellen til uncensored. Du kan justere parametre som temperature og top_p til at kontrollere kreativitet. Højere værdier giver mere varierede svar.

Indstil max_tokens for at begrænse outputlængden. Standard er 2.048 tokens, hvis ikke angivet. Modellen understøtter et kontekstvindue på 100.000 tokens for prompt plus completion. Dette tillader lange samtaler uden afkortning. Juster presence_penalty og frequency_penalty for at reducere gentagelse i roleplay-scenarier.

Brug den stop parameter til at afbryde genereringen ved specifikke sætninger. Dette hjælper med at håndhæve dialog-strukturen. The seed parameter sikrer reproducerbare output til test. Disse værktøjer giver dig præcis kontrol over modellens adfærd.

Streaming-respons og forbrugsdata

Aktivér streaming ved at indstille stream: true i din anmodning. API'et returnerer tekststykker, mens de genereres. Dette reducerer den opfattede latens for slutbrugere. Hver del indeholder delvis tekst og metadata.

Brugsdata vises i den sidste del. Dette inkluderer antal input- og output-tokens. Tjek usage felt i det sidste svarobjekt. Dette muliggør nøjagtig fakturering uden separate API-kald. Spore tokenforbrug i realtid.

Håndter streamafslutning omhyggeligt. Sørg for at behandle alle chunks, før du lukker forbindelsen. Den sidste chunk indeholder de fulde forbrugsstatistikker. Disse data er essentielle til overvågning af omkostninger og ydeevne i produktionsapplikationer.

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)

Fejlhåndtering og hastighedsbegrænsninger

API'en håndhæver en grænse på 300 anmodninger i minuttet per nøgle. Samtidige anmodninger er begrænset til otte per nøgle. Anmodningskroppen må ikke overstige 8 MB. Overskridelse af disse grænser returnerer en 429-fejl. Implementer eksponentiel backoff til at håndføre midlertidige spidser.

Almindelige fejl inkluderer 401 for ugyldige nøgler og 402 for utilstrækkelig kredit. En 402-respons indikerer, at din forudbetalte balance er udtømt. Top op på din konto for at genoptage servicen. Feil forbruger ikke tokens, så et forsøg efter at have rettet problemet er gratis.

Tjek response body for detaljerede fejlmeddelelser. API'en returnerer et JSON-objekt med en fejltype og meddelelse. Brug denne information til at fejlsøge problemer hurtigt. Korrekt fejlhåndling sikrer en jævn oplevelse for dine brugere i perioder med høj trafik.

JSON-tilstand og funktionskald guide

Brug JSON-tilstand ved at indstille response_format til {"type": "json_object"}. Dette tvinger modellen til at outputte gyldig JSON. Ideelt til udtrækning af strukturerede data eller API-svar. Sørg for, at din prompt beskriver den ønskede skema tydeligt.

Function calling gør det muligt for modellen at kalde værktøjer. Definer værktøjer i request body. Modellen returnerer tool calls, når det er passende. Håndter disse calls i din applikationslogik. Dette muliggør komplekse multi-step workflows.

Kombinér JSON-tilstand med funktionkald til robuste integrationer. Valider JSON-output på klientsiden. Brug tool_choice parameter til at kontrollere, hvornår funktioner kaldes. Denne fleksibilitet understøtter forskellige applikationsarkitekturer. Sørg for, at dine værktøjer er veldefinerede for optimal ydeevne.

Modeldetaljer og kontekstvindusbegrænsninger

The uncensored modellen understøtter et kontekstvindue på 100.000 tokens. Dette inkluderer både input-prompten og output-fuldførelsen. Maks output er 16.000 tokens pr. anmodning. Dette giver mulighed for omfattende rollespils-scenarier uden afbrydelse midt i en sætning.

Modellen er open-weight og finjusteret til ubegrænset indhold. Den afviser ikke lovligt voksenindhold. Det er ikke GPT, Claude eller en anden udbyders model. Anmodninger behandles på vores dedikerede servere. Dette sikrer konsekvent ydeevne og lav latens.

Overvåg kontekstforbruget for at holde dig inden for grænserne. API'et sporer tokenforbrug nøjagtigt. Fejl og afslag forbruger ikke tokens. Denne gennemsigtige faktureringsmodel hjælper dig med at forudsige omkostninger. Planlæg dine kontekstvinduer for at maksimere værdien.