API-documentatie voor ongefilterde chatvoltooiingen

Snelstart: Verbind in Python of JavaScript

Verbind met de API door je basis-URL bij te werken en je API-sleutel in te stellen. De endpoint accepteert standaard chat-completion-verzoeken en retourneert tekst. Je hoeft geen aangepaste bibliotheken te installeren als je de officiële OpenAI SDKs gebruikt, omdat de interface exact overeenkomt met hun specificatie.

Begin met een eenvoudig HTTP-verzoek om de connectiviteit te verifiëren. Gebruik de onderstaande curl-opdracht om een basisprompt te verzenden naar de uncensored model. Vervang YOUR_API_KEY met de sleutel die je op je dashboard hebt gegenereerd.

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

Voor Python-ontwikkelaars is het proces bijna identiek. Initialiseer de client met je sleutel en de juiste base URL. Dit zorgt ervoor dat alle verzoeken via onze ongecensureerde servers worden gerouteerd, terwijl de compatibiliteit met bestaande tooling behouden blijft.

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-gebruikers kunnen hetzelfde resultaat bereiken met de Node SDK. Stel de baseURL property naar ons eindpunt. Deze aanpak stelt je in staat de API met minimale codeaanpassingen te integreren in webservers of backenddiensten.

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

Authenticatie en API-sleutelbeheer

Authenticatie is afhankelijk van één API-sleutel die in de header wordt doorgegeven. Voer deze sleutel in de Authorization header voor elk verzoek. Als de sleutel ontbreekt of ongeldig is, retourneert de API direct een 401-fout. Dit zorgt voor veilige toegang tot je vooruitbetaalde tegoed.

Genereer je sleutel op het dashboard. De sleutel wordt één keer getoond bij het aanmaken. Bewaar deze veilig in je omgevingsvariabelen. Deel deze niet openbaar. Elke account ondersteunt één actieve sleutel tegelijk. Het genereren van een nieuwe sleutel maakt de vorige direct ongeldig.

Gebruik de sleutel in je verzoeken zoals dit: Authorization: Bearer YOUR_API_KEY. Deze standaard header-indeling werkt met alle grote SDK's. Houd je sleutel bij de hand voor snelle iteratie tijdens de ontwikkeling.

Chat Completions endpoint parameters

Stuur verzoeken naar de /v1/chat/completions endpoint. Voeg uw messages-array toe en stel het model in op uncensored. Je kunt parameters aanpassen zoals temperature en top_p om de creativiteit te regelen. Hogere waarden leiden tot meer gevarieerde antwoorden.

Instellen max_tokens om de uitvoerlengte te beperken. De standaard is 2.048 tokens als dit niet is gespecificeerd. Het model ondersteunt een contextvenster van 100.000 tokens voor prompt plus voltooiing. Dit maakt lange gesprekken mogelijk zonder truncatie. Pas presence_penalty en frequency_penalty om herhaling in roleplay-scenario's te verminderen.

Gebruik de stop parameter om de generatie te stoppen bij specifieke zinnen. Dit helpt de dialoogstructuur afdwingen. De seed parameter zorgt voor reproduceerbare outputs voor testen. Deze tools geven u precieze controle over het gedrag van het model.

Streaming responses en gebruiksgegevens

Activeer streaming door stream: true in uw verzoek. De API retourneert tekstfragmenten zodra ze worden gegenereerd. Dit vermindert de waargenomen latentie voor eindgebruikers. Elk fragment bevat gedeeltelijke tekst en metadata.

Verbruiksgegevens verschijnen in de laatste chunk. Dit omvat het aantal input- en outputtokens. Controleer de usage veld in het laatste responsobject. Dit stelt je in staat tot accurate facturatieverificatie zonder aparte API-aanroepen. Volg tokenverbruik in real-time.

Verwerk de streambeëindiging zorgvuldig. Zorg ervoor dat je alle blokken verwerkt voordat je de verbinding sluit. Het laatste blok bevat de volledige gebruiksstatisitiek. Deze gegevens zijn essentieel voor het monitoren van kosten en prestaties in productieomgevingen.

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)

Fouthantering en rate limits

De API handhaaft een limiet van 300 verzoeken per minuut per sleutel. Gelijktijdige verzoeken zijn beperkt tot acht per sleutel. Het verzoeklichaam mag niet groter zijn dan 8 MB. Het overschrijden van deze limieten retourneert een 429-fout. Implementeer exponentiële backoff om voorbijgaande pieken af te handelen.

Veelvoorkomende fouten zijn onder meer 401 voor ongeldige sleutels en 402 voor onvoldoende tegoed. Een 402-respons geeft aan dat je vooraf betaalde saldo is opgebruikt. Laad je account bij om de service weer op te starten. Fouten verbruiken geen tokens, dus opnieuw proberen na het oplossen van het probleem is gratis.

Controleer de response body voor gedetailleerde foutberichten. De API retourneert een JSON-object met een fouttype en bericht. Gebruik deze informatie om problemen snel te debuggen. Goede foutafhandeling zorgt voor een soepele ervaring voor je gebruikers tijdens periodes met hoog verkeer.

Handleiding voor JSON-modus en functaanroeping

Gebruik JSON-modus door response_format naar {"type": "json_object"}. Dit forceert het model om geldige JSON uit te voeren. Ideaal voor het extraheren van gestructureerde data of API-antwoorden. Zorg dat je prompt de gewenste schema's duidelijk beschrijft.

Function calling stelt het model in staat tools aan te roepen. Definieer tools in het request body. Het model retourneert tool calls wanneer dit gepast is. Verwerk deze calls in je applicatielogica. Dit maakt complexe multi-step workflows mogelijk.

Combineer JSON-modus met functaanroep voor robuuste integraties. Valideer JSON-uitvoer aan de clientkant. Gebruik de tool_choice parameter om te bepalen wanneer functies worden aangeroepen. Deze flexibiliteit ondersteunt diverse applicatie-architecturen. Zorg dat je tools goed gedefinieerd zijn voor optimale prestaties.

Modelgegevens en contextvensterlimieten

De uncensored het model ondersteunt een contextvenster van 100,000 tokens. Dit omvat zowel de invoerprompt als de uitvoercompletie. Maximaal 16,000 tokens per verzoek. Dit maakt uitgebreide roleplayscenario's mogelijk zonder dat de zin halverwege wordt afgebroken.

Het model is open-weight en afgestemd op onbeperkte inhoud. Het weigert geen wettelijke volwassen onderwerpen. Het is geen GPT, Claude of een ander model van een leverancier. Verzoeken worden verwerkt op onze dedicated servers. Dit zorgt voor consistente prestaties en lage latentie.

Monitor het contextgebruik om binnen de limieten te blijven. De API houdt tokengebruik nauwkeurig bij. Fouten en weigeringen verbruiken geen tokens. Dit transparante facturatiemodel helpt je kosten te voorspellen. Plan je contextvensters om de waarde te maximaliseren.