API-documentatie: Chat-completies voor tekstpipelines

Base URL & Authenticatie

Stel je client eerst in op de base URL https://api.speechtotextapis.com/v1. Deze endpoint is volledig OpenAI-compatible, wat betekent dat je elke standaard openai SDK kunt gebruiken door simpelweg de base_url parameter te overschrijven. Je hoeft je request logica niet te herschrijven; vervang gewoon de URL en injecteer je API-sleutel. Je sleutel wordt direct gegenereerd na de registratie op de key pagina. Deze is gekoppeld aan je account en je kunt hem op elk moment regenereren, waardoor de oude sleutel direct ongeldig wordt. Er is geen telefoonnummer vereist en het trial credit wordt geactiveerd zonder creditcard. Deze opzet houdt je pipeline eenvoudig terwijl je toegang hebt tot een ongecensureerd model dat volwassen content zonder beperkingen verwerkt.

Eerste verzoek

Stuur een standaard POST-verzoek naar /v1/chat/completions. De model-ID is altijd uncensored. Dit model is een open-weight-variant die is afgestemd op minimale weigering bij legale onderwerpen. Het draait op onze dedicated GPU-servers. Je krijgt geen GPT of Claude; je krijgt een consistente ervaring met één model. De request body bevat de vlaggen model, messages en stream. Hieronder vind je een basis cURL-voorbeeld om de connectiviteit te verifiëren en een tekstrespons te krijgen.

Copycurl https://api.speechtotextapis.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."}]
  }'

Dit verzoek retourneert een JSON-object met de gegenereerde tekst. Als de sleutel ongeldig is, ontvang je een 401-fout. Als je prepaid tegoed op is, ontvang je een 402-fout. Dit zijn de primaire punten die je moet controleren voordat je de logica debugt.

Python SDK-integratie

Voor Python-ontwikkelaars werkt de officiële openai-bibliotheek direct. Initialiseer de client met je sleutel en de aangepaste base URL. Geef de model-ID uncensored mee in je chat completion call. Deze aanpak is ideaal voor post-processing van ASR-uitvoer, het opruimen van transcriptieraar of het extraheren van gestructureerde data uit ruwe tekst. Het ongecensureerde karakter zorgt ervoor dat de LLM je transcript verwerkt zonder blokkades of herschrijving voor de juiste vorm, zelfs als het transcript volwassen dialoog of controversiële termen bevat. Dit is cruciaal voor creatieve pipelines waar trouw aan de bronaudio voorop staat. De SDK verwerkt tokenization en retry-logica automatisch.

Copyfrom openai import OpenAI

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

Onthoud dat de model ID strikt uncensored is. Vervang deze niet door gpt-4 of andere generieke identifiers, omdat deze mogelijk niet naar onze specifieke ongecensureerde weights routeren.

Node SDK-integratie

Node.js ontwikkelaars kunnen het openai npm package op dezelfde manier gebruiken. Stel de apiKey en baseURL in in de client constructor. Roep vervolgens chat.completions.create aan met het uncensored model. Dit is nuttig voor real-time captioning scripts of server-side tekst generatie taken. De API ondersteunt standaard JSON payloads. Je kunt system messages opnemen om de toon of rol van de assistant te definiëren. Het ongecensureerde model reageert direct op deze prompts zonder extra safety layers die creative output zouden kunnen wijzigen. Zorg dat je de response stream afhandelt als je grote documenten verwerkt. De Node SDK abstrahert de HTTP details, zodat je je kunt concentreren op de tekst pipeline logica.

Copyimport OpenAI from "openai";

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

Rate limits gelden per sleutel. Als je meer dan 300 verzoeken per minuut overschrijdt, retourneert de API een 429 fout. Implementeer exponentiële backoff in je retry logica om dit soepel af te handelen.

Streaming responses (SSE)

Voor applicaties met lage latentie, activeer streaming door stream: true in je request in te stellen. De API retourneert Server-Sent Events (SSE) chunks. Elke chunk bevat een gedeeltelijke tekst delta. Dit is essentieel voor live captioning of interactieve chat interfaces. Het ongecensureerde model ondersteunt streaming native. Je hoeft niet te wachten op de volledige completion om tekst te beginnen weergeven. Dit vermindert de waargenomen latentie aanzienlijk. Configureer je SDK om de stream events af te handelen. In Python itereren over het stream object. In Node gebruik je de async iterator. De stream eindigt met een laatste chunk met de finish reason. Deze methode is efficiënt voor bandbreedte en gebruikerservaring.

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)

Streaming verandert de token facturering niet. Je wordt gefactureerd voor het totale aantal input en output tokens, ongeacht of je streamt of een volledige response aanvraagt.

Limieten & beperkingen

Je account heeft een harde limiet van 300 verzoeken per minuut per API-sleutel. De request body mag niet groter zijn dan 8 MB. Het contextvenster is 100.000 tokens, zowel voor prompt als completion. Dit is voldoende voor de meeste documentverwerking en long-context transcripcie taken. Als je een prompt stuurt die het venster overschrijdt, retourneert de API een fout. Het ongecensureerde model blokkeert slechts één specifieke harde limiet: seksuele content met minderjarigen. Alle andere lawful adult content is toegestaan. Dit maakt het ideaal voor media pipelines waar content variatie wordt verwacht. Er zijn geen abonnementen; je betaalt per gebruik. Prepaid tegoed vervalt niet. Gebruik het GET /v1/models endpoint om beschikbaarheid te verifiëren indien nodig, hoewel de model ID altijd uncensored is.