NL ▾

speechtotextapis.comOngecensureerd LLM voor tekstpipelines na post-processing

Speech To Text API
API-sleutel aanvragen

OpenAI-compatible API-sleutel: Maak er een en stuur een verzoek

Een OpenAI-compatible API-sleutel is een normale bearer token die werkt met elke OpenAI SDK zodra je de client op een andere base URL wijst. Deze pagina laat zien hoe je er een krijgt voor de gehoste tekst-API op deze site en binnen enkele minuten een werkend verzoek verstuurt.

BijgewerktSpeech To Text API

Een gloeiende sleutel die een terminalvenster verbindt met een server, ter illustratie van een API-sleutel voor een compatibele tekst-API

Wat de sleutel precies is

"OpenAI-compatible" beschrijft de vorm van de HTTP-API, niet het bedrijf erachter. De dienst accepteert dezelfde JSON-body op POST /v1/chat/completions die de OpenAI SDK's versturen, en leest dezelfde Authorization: Bearer header. Hierdoor past een sleutel van deze dienst in elke tool waarmee je een aangepaste base URL en API-sleutel kunt instellen: de officiële Python- en Node-bibliotheken, LangChain, gewone curl en de meeste desktop chatclients.

Deze sleutel is geen OpenAI-sleutel en werkt niet op api.openai.com. Omgekeerd werkt een OpenAI-sleutel hier ook niet. Elke sleutel hoort bij één service, en deze draait een enkel open-weight model, afgestemd op antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen, gehost door een onafhankelijke provider. Het is niet de officiële API van een modelleverancier en het routeert niet naar andere leveranciers.

Onthoud het volgende. De base URL voor deze site is https://api.speechtotextapis.com/v1. De model-ID is uncensored. De sleutel is de string die je krijgt na het aanmelden. Alles hieronder is een variatie op die drie waarden.

De service is tekst alleen. Het verwerkt chatcompleties, streaming, function calling en JSON-modus. Het genereert geen afbeeldingen of audio, biedt geen embeddings aan en fine-tunt geen modellen. Als je hier vandaan komt uit een speech-pipeline, is de gebruikelijke taak de tekststap na transcriberen: een transcript opschonen, opsplitsen in scènes, dialoog herschrijven of gestructureerde data extraheren. De gids voor het verwerken van voicescripts behandelt dit detailijker.

Haal je sleutel in vier stappen

  1. Registreer je. Gebruik Google, of registreer je met een e-mailadres en een wachtwoord.
  2. Open de API-sleutelpagina. Deze bevindt zich op de sleutelpagina van deze site. Je sleutel wordt daar aangemaakt en getoond.
  3. Claim het trial tegoed. Een knop op dezelfde pagina geeft je $0,50 aan trial tegoed met één klik. Het is één per persoon, geldig voor 7 dagen, en vereist geen kaart.
  4. Kopieer de sleutel naar een secret store. Een environment variable is genoeg voor een lokale test. Voor elke deployment gebruik je de secret manager van je host.

Het proeftegoed is bedoeld om te bewijzen dat de integratie werkt voordat je iets betaalt. Voor de huidige prijs is het genoeg voor veel korte verzoeken, en het kostenoverzicht hieronder toont de berekening. Wanneer je klaar bent om door te gaan, toont de prijzenpagina de opwaardeerbedragen. Het tegoed is prepaid, er is geen abonnement, en het tegoed verloopt nooit, dus er is geen druk om een opwaardering uit te geven voor een bepaalde datum.

Proefsleutels hebben strengere limieten dan volledige sleutels: 2 gelijktijdige verzoeken en 60 verzoeken per minuut. Dat is meer dan genoeg voor een eerste script. Als je van plan bent tientallen transcriptfragmenten parallel uit te voeren, verwacht dan de limiet te raken totdat je naar een gefinancierd account gaat.

De drie instellingen die elke client vraagt

Welke software je ook gebruikt, het configuratiescherm vraagt om dezelfde drie dingen onder iets andere namen.

InstellingTypische veldnaamWaarde
EndpointBase URL, API-base, hosthttps://api.speechtotextapis.com/v1
ReferentiegegevensAPI-sleutel, token, secretJe sleutel van de sleutelpagina
ModelModel, modelnaam, engineuncensored

Eén detail zorgt voor verwarring: de base URL eindigt al op /v1. De SDK's voegen /chat/completions zelf toe, dus je moet het niet toevoegen. Als je client om de volledige URL van het chat-endpoint vraagt in plaats van een base, is de waarde https://api.speechtotextapis.com/v1/chat/completions.

Als een tool alleen een "OpenAI"-preset aanbiedt met een hard-coded host en geen mogelijkheid om deze te bewerken, kan deze niet met deze dienst communiceren. Zoek naar een optie "custom", "OpenAI-compatible" of "geavanceerd" die het base URL-veld blootlegt.

Je eerste verzoek

Begin met curl, omdat dit elke laag tussen jou en de API verwijdert. Vervang YOUR_KEY door de sleutel die je hebt gekopieerd.

curl https://api.speechtotextapis.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
      {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
    ]
  }'

Een succesvol antwoord is een JSON-object met een choices-array. De tekst staat in choices[0].message.content, en een usage-blok rapporteert de tokens waarvoor je bent gefactureerd.

Dezelfde aanroep met de officiële Python-library ziet er zo uit. Alleen base_url en api_key verschillen van een standaard OpenAI-setup.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.speechtotextapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
        {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
    ],
)
print(resp.choices[0].message.content)

En in Node, met hetzelfde pakket:

import 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: "Rewrite this in plain English: the beta shipped on Tuesday." },
  ],
});
console.log(resp.choices[0].message.content);

Je hoeft max_tokens niet in te stellen. Als je het weglaat, kan de voltooiing gebruikmaken van wat er overblijft van het 100.000-token contextvenster na je prompt. Stel het zelf in als je een hard plafond wilt voor de kosten per aanroep.

Controleer of de sleutel werkt zonder tokens te verbruiken

Voordat je een sleutel in een groter systeem integreert, maak je één goedkoop verzoek naar het models-endpoint. Dit bevestigt dat de sleutel wordt geaccepteerd en de base URL correct is.

curl -i https://api.speechtotextapis.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

De vlag -i print responsheaders, waar deze API nuttige statusgegevens rapporteert:

  • X-Request-Id identificeert het verzoek. Voeg het toe als je support contacteert over een specifiek verzoek.
  • X-Balance-USD toont het resterende tegoed op het account.
  • X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency tonen de limieten die voor je sleutel gelden, zodat je in één oogopslag ziet of de sleutel trial- of volledige limieten heeft.

Het lezen van X-Balance-USD in je eigen code is een goedkope manier om jezelf te waarschuwen voordat het tegoed op raakt. Log het één keer per taak in plaats van één keer per verzoek als je geen luidruchtige output wilt.

Wat een sleutel kost om te gebruiken

Een sleutel hebben kost niets. Je betaalt voor tokens: $0.15 per 1M input tokens en $0.50 per 1M output tokens, afgeschreven van prepaid tegoed. Mislukte of geweigerde verzoeken worden niet in rekening gebracht.

Een werkvoorbeeld met de transcript cleanup aanroep hierboven. Stel een prompt is 1.000 tokens en het opgeschoonde antwoord is 500 tokens.

  • Input: 1.000 / 1.000.000 x $0,15 = $0,00015
  • Output: 500 / 1.000.000 x $0,50 = $0,00025
  • Totaal: $0.0004 per aanroep

De $0.50 proef dekt dus ongeveer 1.250 aanroepen van die grootte ($0.50 / $0.0004). Je eigen cijfers zullen verschillen, omdat transcripten variëren in lengte, maar de methode is hetzelfde: tel de tokens in, tel de tokens uit, vermenigvuldig.

Wanneer je opwaardeert, wordt elk geheel bedrag van $20 tot $500 geaccepteerd. Grotere top-ups hebben een bonus: +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Een $100 top-up geeft je bijvoorbeeld $110 tegoed. Je kunt betalen met crypto (USDT op TRC20, USDC op Base).

De sleutel veilig houden

Een API-sleutel is een wachtwoord voor je saldo. Iedereen die hem heeft, kan je tegoed uitgeven, dus behandel hem als zodanig.

  • Houd het buiten broncodebeheer. Lees het uit een omgevingsvariabele of een secret manager.
  • Stuur het niet mee in browser-JavaScript of een mobiel app-bundle. Alles wat op het apparaat van de gebruiker draait, kan worden geïnspecteerd. Plaats een kleine server tussen je front-end en de API en laat de server de header toevoegen.
  • Plak het niet in screenshots, tickets of chatberichten.
  • Als je denkt dat een sleutel is gelekt, stop dan met het gebruik ervan en neem direct contact op met de support in plaats van af te wachten of er iets gebeurt.

Op het gebied van privacy: prompts die naar de API worden gestuurd, worden niet gebruikt voor training. Dit is een mededeling over de dienst, geen reden om geheimen te sturen die je niet hoeft te sturen. Verwijder persoonlijke gegevens uit transcripties wanneer de taak dit niet vereist.

Wanneer een verzoek mislukt

De meeste problemen op de eerste dag komen door een van vier oorzaken.

De base URL is verkeerd

De twee veelgemaakte fouten zijn een ontbrekende /v1 en een verdubbeling van /chat/completions. Vergelijk je waarde teken voor teken met die in de tabel hierboven.

De sleutel bevat een vreemd teken

Kopiëren van een pagina brengt vaak een trailing space of newline mee. Knip de waarde in je code bij en controleer of de header Bearer leest, één spatie, gevolgd door de sleutel.

De modelnaam is niet uncensored

Clients gebruiken vaak een andere modelnaam als standaard. Stel het model expliciet in bij elk verzoek.

HTTP 429

Er zijn twee varianten, en de foutcode maakt ze van elkaar onderscheiden. rate_limited betekent dat je te veel verzoeken per minuut hebt gestuurd. concurrency betekent dat er te veel tegelijkertijd actief waren. Een gestreamd verzoek houdt zijn concurrency-slot vast tot de stream eindigt, dus een trage lezer kan deze fout veroorzaken, zelfs bij een laag verzoektempo. Een 429 met een Retry-After: 5-header betekent dat de service kortstondig overbelast is; wacht vijf seconden en probeer het opnieuw. Een korte exponentiële backoff in je client behandelt alle drie de gevallen.

Voor de volledige parameterlijst, streaming-formaat en details over tool calling, zie de API-documentatie.

Vragen en antwoorden

Is dit hetzelfde als een OpenAI-sleutel?

Nee. Het volgt hetzelfde verzoekformaat, dus OpenAI SDK's werken ermee, maar het wordt uitgegeven door deze dienst en werkt alleen tegen de base URL van deze dienst.

Heb ik een creditcard nodig om een sleutel te krijgen?

Nee. Meld je aan met Google of e-mail en claim het $0,50 proeftegoed met één klik op de sleutelpagina. Het proeftegoed vereist geen kaart en is 7 dagen geldig.

Welke modelnaam moet ik gebruiken?

Gebruik uncensored in het modelveld. Een verzoek naar GET /v1/models geeft aan wat de sleutel kan benaderen.

Kan ik dezelfde sleutel van meerdere servers gebruiken?

Ja, maar de limieten gelden voor de sleutel als geheel: 8 gelijktijdige verzoeken en 300 verzoeken per minuut op een volledige sleutel, 2 en 60 op een proefsleutel.

Werkt de sleutel voor afbeeldingen of spraak?

Nee. De API is alleen voor tekst. Hij genereert of transcribeert geen audio of afbeeldingen, en heeft geen embeddings of fine-tuning.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel ophalenDocumentatie lezen