Stap-voor-stap integratie van de uncensored.com LLM API

Vereisten: SDK en omgevingconfiguratie

Installeer de SDK voor je favoriete taal om communicatie met het eindpunt mogelijk te maken. De meeste ontwikkelaars gebruiken de officiële OpenAI SDK voor Python, Node.js of Go. Dit werkt omdat de API de standaard OpenAI-chatcompletieschema volgt.

Zorg ervoor dat je omgeving Python 3.8+ of Node.js 18+ heeft. Installeer het pakket via pip of npm. Je hebt een API-sleutel nodig vanuit het dashboard. Er is geen telefoonnummer nodig voor registratie.

• Python: pip install openai
• Node.js: npm install openai

Bewaar je API-sleutel in een omgevingsvariabele. Dit voorkomt onbedoelde blootstelling in versiebeheer. De sleutel geeft toegang tot het uncensored-model.

De basis-URL configureren

Wijs uw SDK-client naar de juiste basis-URL. Dit is de meest kritische stap voor een succesvolle integratie. De standaard OpenAI-basis-URL werkt niet voor deze service.

Stel de basis-URL in op HTTPS://api.uncensoredaicom.com/v1. Dit stuurt verzoeken naar de uncensored-LLM-infrastructuur. De model-ID die je moet verzenden is "uncensored". Het is een open-weight model dat is afgestemd op minimale weigeringen.

Verifieer de verbinding door het models endpoint aan te roepen. Dit bevestigt dat uw referenties en basis-URL correct zijn. Een succesvol antwoord retourneert de model ID en objecttype.

Authenticatie en headerinstelling

Voer uw API-sleutel in de Authorization-header. Gebruik de Bearer-scheme voor alle verzoeken. Deze header verifieert uw voorbetaalde creditaccount.

Stel de header in als: Authorization: Bearer YOUR_API_KEY. De SDK verwerkt dit automatisch als je de sleutel aan de clientconstructor doorgeeft. Zorg dat er geen extra spaties zijn opgenomen. Ongeldige sleutels retourneren een 401 Unauthorized-fout.

Je krijgt één actieve sleutel per account. Het genereren van een nieuwe sleutel maakt de vorige ongeldig. Dit vereenvoudigt sleutelrotatie en beveiligingsbeheer. Bewaar je sleutel veilig in je deployomgeving.

Een standaard chatverzoek versturen

Stuur een POST-verzoek naar /v1/chat/completions. Stuur je berichten als een array van role- en content-objecten. Het systeem ondersteunt user-, assistant- en system-roles.

Voorbeeldstructuur: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. De API retourneert een tekstcompletie. Het contextvenster is 100,000 tokens in totaal. Maximaal uitvoer is 16,000 tokens per verzoek.

Fouten en weigeringen verbruiken geen credit. Dit beschermt je prepaid saldo. Stel temperatuur en top_p in voor controle. Standaardwaarden werken voor de meeste use cases.

Streaming inschakelen voor realtime uitvoer

Instellen stream: true in je aanvraaglichaam. Dit activeert Server-Sent Events (SSE). Tokens komen incrementeel aan in plaats van te wachten op de volledige voltooiing.

Parseer de SSE-stream om tekst in real time weer te geven. Het laatste blok bevat statistieken over tokengebruik. Dit stelt u in staat de facturering nauwkeurig bij te houden. Streaming vermindert de waargenomen latentie voor eindgebruikers.

Verwerk netwerkonderbrekingen beheersbaar. Herverbind als de stream verbreekt. De uncensored API ondersteunt stabiele streaming. Monitor de verbindingstoestand. Gebruik dit voor chatinterfaces of generatie van lange teksten.

Tools en Function Calling gebruiken

Definieer tools in de request body. Voeg een lijst met funtieschema's toe. Het model kan deze functies aanroepen op basis van de gebruikersintentie. Dit maakt agent-achtig gedrag mogelijk.

Specify tool_choice om functiekeuze te regelen. Gebruik auto voor automatische detectie. De API ondersteunt standaard tool-definities. Parseer de functie-aanroepargumenten uit de respons.

Implementeer de functie-uitvoering in je code. Stuur het resultaat terug als bericht. Het model gaat door met het gesprek. Dit maakt complexe workflows mogelijk. Testen zorgt voor nauwkeurige argumentparsing.

Afhandeling van JSON-modusresponsen

Instellen response_format: {"type": "json_object"}. Dit forceert het model om geldige JSON uit te voeren. Gebruik dit voor het extraheren van gestructureerde data. Het voorkomt fouten door malformed responses.

Parseer de JSON-string in uw code. Afhandelen van mogelijke parsingsfouten. JSON-modus verbetert de betrouwbaarheid voor API-integraties. Het is ideaal voor gegevensverwerkingspipelines.

Combineer JSON-modus met systeemprompts. Stuur het model aan om specifieke schema's uit te voeren. Dit zorgt voor consistente opmaak. Valideer de uitvoer voordat u deze gebruikt. Dit vermindert downstream-fouten.

Monitoring van limieten en fouten

Houd rekening met de rate limits. Je krijgt 300 verzoeken per minuut per sleutel. Maximaal 8 gelijktijdige verzoeken. De grootte van de request body is beperkt tot 8 MB.

Monitor HTTP-statuscodes. 429 geeft aan dat de rate limit is overschreden. 400 geeft een slecht verzoek aan. 500 geeft een serverfout aan. Implementeer exponentiële backoff voor retries. Dit voorkomt dat de API overweldigd wordt.

Volg tokengebruik in de laatste streamende chunk. Dit helpt uw vooruitbetaalde credit beheren. Fouten verbruiken geen tokens. Dit beschermt uw saldo. Regelmatige monitoring zorgt voor een vlotte werking.

Kostenberekening en tokengebruik

De prijzen zijn transparant en prepaid. Inputtokens kosten $0,15 per miljoen. Outputtokens kosten $0,50 per miljoen. Tegoed verloopt niet. Er zijn geen maandelijkse kosten.

Laad op met crypto alleen. USDT (TRC20) of USDC (Base). Bedragen variëren van $20 tot $500. Bonus tegoed is van toepassing bij hogere stortingen. +5% vanaf $50, +10% vanaf $100, +15% vanaf $200.

Bereken kosten voordat je zwaar gaat gebruiken. Schat tokenaantallen voor je prompts. Dit helpt bij het effectief budgetteren. Fouten zijn gratis. Restituties worden niet gegeven, maar fouten worden gecorrigeerd. Gebruik het dashboard om uitgaven te volgen.