Belangrijkste punten
- De ongecensureerde API volgt de standaard OpenAI-syntaxis, maar mist geavanceerde functies zoals embeddings of routing tussen meerdere modellen, dus je client moet worden geconfigureerd voor één endpoint.
- Streaming-antwoorden vereisen specifieke SSE-handhaving; als je SDK standaard naar JSON-parsing neigt, krijg je parsingfouten bij grote ongecensureerde outputs.
- Function calling werkt, maar vereist strikte naleving van het JSON-schema omdat het model vaker argumenten kan hallucineren dan instruction-tuned modellen.
- Je bent beperkt tot 300 verzoeken per minuut en een body-grootte van 8 MB, wat zorgvuldige batching-strategieën vereist voor applicaties met een hoog volume.
Het ongecensureerde AI API-endpoint begrijpen
Bij het integreren van een ongecensureerde AI API is de eerste fout de aanname dat het zich identiek gedraagt als standaard commerciële modellen. Ons endpoint is een gehoste, OpenAI-compatibele chat-completions-service. Het levert één toegewijd ongecensureerd large language model. Dit betekent dat je geen modelrouting of versiebeheer hoeft te beheren. Je stuurt verzoeken naar POST /v1/chat/completions en ontvangt tekst als antwoord.
In tegenstelling tot aggregators die afbeeldingen, video's en meerdere leveranciers bundelen, richt deze service zich puur op high-performance, unrestricted tekstgeneratie. Het model is een open-weight model en is afgestemd om te antwoorden zonder content refusals voor wettelijk volwassen gebruik. Het is echter geen GPT, Claude, Gemini of een model van een andere leverancier. Het draait op onze eigen GPU-servers.
De base URL is https://api.uncensoredgptapi.com/v1. Om het te gebruiken, wijzig je de base_url in je bestaande OpenAI SDK's of elke OpenAI-compatibele client en geef je je API-sleutel op. De model ID die je moet verzenden is eenvoudigweg "uncensored". Deze eenvoud vermindert de integratietijd, maar vereist dat je verifieert dat je client één-model endpoints kan afhandelen zonder fallbacks te verwachten.
Veelvoorkomende authenticatiefouten
Authenticatiefouten ontstaan meestal door verkeerd geconfigureerde headers of verlopen sleutels. De API gebruikt standaard Bearer token-authenticatie. Je moet je API-sleutel opnemen in de Authorization header voor elk verzoek.
Een veelgemaakte fout is het cacheën van de API-sleutel zonder de geldigheid te verifiëren. Als je je sleutel regenerert, wordt de oude sleutel onmiddellijk ongeldig gemaakt. Je moet je clientconfiguratie bijwerken om de nieuwe sleutel te gebruiken. Als je een 401 Unauthorized-fout ontvangt, controleer dan twee dingen: zorg eerst dat de sleutel correct is gekopieerd zonder spaties aan het begin of einde. Controleer vervolgens of je de juiste base URL gebruikt. Zelfs een kleine afwijking in het domein of pad leidt tot authenticatiefouten.
Een ander veelvoorkomend probleem is het gebruik van de verkeerde model ID. Het endpoint verwacht "uncensored". Als je "gpt-4" of een andere standaard model ID verzendt, kan het endpoint het verzoek afwijzen of een fout retourneren omdat het slechts één model levert. Controleer altijd het model veld in je request payload.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Streaming-antwoorden correct afhandelen
Streaming-antwoorden via Server-Sent Events (SSE) worden ondersteund, maar worden vaak verkeerd afgehandeld door ontwikkelaars die gewend zijn aan synchronische JSON-antwoorden. Wanneer je "stream": true instelt in je verzoek, retourneert de API een stream van gedeeltelijke JSON-objecten, niet één volledig JSON-antwoord.
Als je client probeert het volledige antwoord in één keer te parseren als JSON, zal dit falen. Je moet de stream regel voor regel lezen. Elke regel begint met data: en bevat een gedeeltelijk JSON-object. De laatste regel is data: [DONE]. Je code moet deze chunks aggregeren om de uiteindelijke tekst te reconstrueren.
Sommige SDK's verwerken dit automatisch, maar aangepaste implementaties hebben expliciete SSE-parsing nodig. Zorg ervoor dat je clientbuffer grote outputs kan afhandelen zonder time-outs. Het ongecensureerde model kan lange antwoorden genereren, en streaming helpt bij het beheer van het geheugengebruik. Als je verbindingen verliest, overweeg dan exponentiële backoff te implementeren voor retry-logica.
stream = 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)Fouten in de tool calling-configuratie
Function calling wordt ondersteund, maar het ongecensureerde model kan vaker argumenten hallucineren dan instruction-tuned modellen. Dit vereist strengere validatie aan jouw kant. Wanneer je tools definieert, zorg er dan voor dat je JSON-schema nauwkeurig is. Het model zal proberen de argumenten in te vullen, maar het kan vereiste velden weglaten of onjuiste typen bieden.
Valideer altijd de tool calling-argumenten voordat je de functie uitvoert. Als het model ongeldige JSON retourneert voor de argumenten, moet je de fout op een beheersbare manier afhandelen. Ga er niet van uit dat de output perfect gestructureerd is. Je moet mogelijk een retry-mechanisme of een post-processingstap implementeren om de argumenten op te schonen.
Houd er ook rekening mee dat het ongecensureerde model tool definitions kan negeren als de prompt complex is. Als je problemen ondervindt, vereenvoudig dan de tool beschrijvingen en zorg ervoor dat de system prompt het model duidelijk instrueert om de tools te gebruiken wanneer dit gepast is. Test met een paar voorbeeldinvoer om het gedrag te verifiëren.
Limieten van het contextvenster (100k tokens)
De ongecensureerde API ondersteunt een contextvenster van 100.000 tokens, inclusief zowel prompt als completion. Dit is aanzienlijk groter dan veel standaardmodellen, waardoor uitgebreide gesprekken of de verwerking van grote documenten mogelijk zijn. Het is echter niet oneindig. Als je input deze limiet overschrijdt, retourneert de API een fout.
Om deze limiet te vermijden, houd je tokengebruik in de gaten. De meeste SDK's bieden hulpmiddelen om tokens te tellen. Houd het cumulatieve aantal tokens in je gespreksgeschiedenis bij. Als je grote documenten verwerkt, overweeg dan om ze in chunks te verdelen of eerdere delen van het gesprek samen te vatten om contextruimte vrij te maken.
Onthoud dat het contextvenster alle berichten in de messages array omvat. Elk bericht draagt bij aan het totaal. Als je veel kleine berichten verzendt, kan de overhead oplopen. Optimaliseer je promptstructuur om onnodige tokens te minimaliseren. Vermijd bijvoorbeeld het herhalen van system instructions in elke beurt als deze constant blijven.
Rate limiting uitgelegd (300 RPM)
De API handhaaft een rate limit van 300 verzoeken per minuut per sleutel. Dit is een harde limiet om eerlijk gebruik door alle gebruikers te garanderen. Als je deze limiet overschrijdt, ontvang je een 429 Too Many Requests-fout. Je client moet dit afhandelen door een retry-strategie te implementeren.
Een veelgemaakte fout is het niet rekening houden met burst traffic. Als je 300 verzoeken snel achter elkaar verzendt, kun je de limiet raken, zelfs als je gemiddelde snelheid lager is. Verdeel je verzoeken gelijkmatig over de minuut. Als je een grote dataset verwerkt, overweeg dan om verzoeken te bundelen of een wachtrij te gebruiken om de stroom te beheren.
Rate limits worden toegepast per API-sleutel. Als je meerdere services hebt die dezelfde sleutel gebruiken, delen ze de limiet. Om de capaciteit te verhogen, kun je een nieuwe sleutel genereren, maar houd er rekening mee dat slechts één sleutel actief is per account. Je kunt de sleutel op elk moment regenereren, maar hiermee wordt de oude sleutel ongeldig, dus zorg ervoor dat alle clients zijn bijgewerkt.
Limieten voor request body-grootte (8MB)
Elke request body is beperkt tot 8 MB. Deze limiet geldt voor de JSON-payload, inclusief de messages array en eventuele tool definitions. Als je verzoek deze grootte overschrijdt, wijst de API het af met een 413 Payload Too Large-fout.
Deze limiet is belangrijk bij het verzenden van grote bestanden als base64-gecodeerde data of bij het opnemen van uitgebreide gespreks geschiedenissen. Als je werkt met grote documenten, overweeg dan de tekst te comprimeren of onnodige spaties te verwijderen voordat je verzendt. Je kunt ook streaming gebruiken om het geheugengebruik te verminderen, maar de initiële request body moet nog steeds binnen de 8 MB limiet passen.
Monitor je request groottes tijdens de ontwikkeling. Als je deze fout tegenkomt, controleer dan je promptstructuur en verwijder overtollige informatie. Als je bijvoorbeeld het volledige system prompt in elk bericht opneemt, verplaats het dan naar de system role één keer en verwijs ernaar.
API-sleutelbeheer en regeneratie
Elk account is beperkt tot één API-sleutel. Deze sleutel wordt gegenereerd tijdens de aanmelding en wordt direct getoond. Je kunt de sleutel op elk moment regenereren vanuit je dashboard. Wanneer je regenerert, wordt de oude sleutel onmiddellijk ongeldig gemaakt. Elke client die de oude sleutel gebruikt, ontvangt een 401 Unauthorized-fout.
Om dit effectief te beheren, werk je alle clients bij voordat je de sleutel regenerert. Als je meerdere services of apparaten hebt die de sleutel gebruiken, zorg er dan voor dat ze allemaal gelijktijdig zijn bijgewerkt. Je kunt zo vaak een nieuwe sleutel genereren als nodig is, maar er is altijd maar één actief op een moment.
De API-sleutel is gekoppeld aan je e-mail en wachtwoord. Als je je sleutel verliest, kun je deze regenereren. Er is geen limiet aan het aantal regeneraties. Frequent regenereren kan echter wijzen op een veiligheidsprobleem, dus gebruik het wanneer nodig. Houd je sleutel veilig en deel deze niet openbaar.
Content filters oplossen
Het ongecensureerde model weigert wettelijk volwassen, fictief, security-onderzoek of controversiële onderwerpen niet. Er is echter één harde contentlimiet die altijd geldt: geen seksuele inhoud met minderjarigen. Verzoeken met deze inhoud worden geblokkeerd.
Als je onverwachte refusals tegenkomt, controleer je dan prompt op subtiele indicatoren van verboden inhoud. Het model is afgestemd voor unrestricted gebruik, maar het kan nog steeds basisveiligheidsfilters toepassen. Als je test met edge cases, documenteer dan het gedrag om de grenzen van het model te begrijpen.
Een ander veelvoorkomend probleem is hallucinatie. Het ongecensureerde model kan plausibel klinkende maar onjuiste informatie genereren. Verifieer altijd kritieke outputs, vooral bij het gebruik van tool calls of het genereren van code. Het model geeft in sommige gevallen de voorkeur aan vloeiheid boven strikte feitelijke nauwkeurigheid.
