API Documentatie

Snelstart: uw eerste verzoek

Verstuur je eerste bericht naar het uncensored-model direct. Gebruik het standaard chat-completions-eindpunt om tekst te genereren. Het model reageert op natuurlijke taalprompts zonder inhoudsweigeringen voor wettelijk volwassen gebruik. Deze setup werkt met elke OpenAI-compatible client.

Installeer eerst de SDK voor uw voorkeurstaal. Configureer vervolgens uw API-sleutel. Het volgende voorbeeld toont een eenvoudige curl-request om de connectiviteit te testen.

U kunt parameters aanpassen zoals temperature om de willekeur te beheren. De respons retourneert gegenereerde tekst direct. Deze eenvoudige flow stelt u in staat de API te verifiëren voordat u complexe logica bouwt.

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

Basis-URL en authenticatie

Maak verbinding met de speciale basis-URL voor deze API. Vervang het standaard eindpunt door ons gehoste serveradres. Dit zorgt ervoor dat uw verzoeken direct het uncensored-model bereiken. Authenticatie is afhankelijk van één API-sleutel per account.

Genereer je sleutel via het dashboard. Geef deze door in de Authorization-header als Bearer-token. Deze methode is compatibel met standaard OpenAI SDK's. Je kunt van provider wisselen door alleen de basis-URL en sleutel aan te passen.

Houd je sleutel veilig. Deze geeft volledige toegang tot je voorgekochtegoed. De sleutel vervangt elke vorige actieve sleutel onmiddellijk bij generatie.

Eindpunten: Chatvoltooiingen

Interacteer met het model via het chat-completions eindpunt. Dit is het enige beschikbare eindpunt voor tekstgeneratie. Het accepteert berichten en retourneert gegenereerde tekst. Geen embeddings, afbeeldingen of audio worden ondersteund.

Stuur een POST-verzoek naar de chat-route. Voeg je systeem- en gebruikersberichten toe aan de body. Het model verwerkt de context en genereert een antwoord. Je kunt JSON-modus gebruiken voor gestructureerde uitvoer.

Function calling wordt ook ondersteund. Definieer tools en laat het model beslissen wanneer ze gebruikt moeten worden. Deze flexibiliteit maakt complexe agent-workflows mogelijk. De respons bevat de gegenereerde inhoud en token-gebruik.

Copyfrom openai import OpenAI

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

Parameters: Temperatuur, Top P en Stop

Stuur de outputstijl aan met standaardparameters. Pas de temperatuur aan om de creativiteit te wijzigen. Lagere waarden maken antwoorden meer deterministisch. Hogere waarden introduceren meer variatie.

Gebruik top P om onwaarschijnlijke woorden te filteren. Dit helpt de coherentie te behouden terwijl creativiteit wordt toegestaan. Stel stop-sequenties in om de generatie te beëindigen bij specifieke markeringen. Dit is nuttig voor het beheersen van de dialoogstructuur.

De seed-parameter zorgt voor reproduceerbare resultaten. Gebruik deze tijdens het debuggen van je prompts. Deze parameters geven je precieze controle over het gedrag van het model. Stel ze af om ze aan te passen aan de behoeften van je applicatie.

Copyimport OpenAI from "openai";

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

Streaming en Token-gebruik

Ontvang antwoorden in realtime met behulp van server-sent events. Streamen vermindert de waargenomen latentie voor gebruikers. De API stuurt tokens zodra ze worden gegenereerd. Dit creëert een soepeler leeservaring.

Tokengebruik wordt gerapporteerd in het laatste chunk. Hiermee kun je kosten nauwkeurig bijhouden. Facturering is gebaseerd op daadwerkelijk verbruikte tokens. Fouten en weigeringen kosten niets.

Implementeer een streamhandler om de gegevens te verwerken. Werk je UI bij wanneer tokens aankomen. Deze aanpak is ideaal voor chatinterfaces. Het model ondersteunt streamen voor alle aanvraagtypes.

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)

Rate Limits en beperkingen

Begrijp de limieten om serviceonderbrekingen te voorkomen. Je kunt 300 verzoeken per minuut per sleutel uitvoeren. Gelijktijdige verzoeken zijn beperkt tot acht tegelijk. De request body mag niet groter zijn dan 8 MB.

Handel fouten soepel af. Een 401-status betekent dat je sleutel ongeldig is. Een 402-status geeft aan dat er onvoldoende credit is. Een 429-status signaleert dat je de limiet hebt bereikt.

Het contextvenster ondersteunt in totaal 100.000 tokens. Dit omvat zowel prompt als completion. Maximaal 16.000 tokens per verzoek. Stel max_tokens in om de uitvoerlengte te bepalen. Fouten zijn gratis, dus retry-logica is veilig.