Transkriptions-API: Overblik, godkendelse og grænser
Sådan bruger du VoxScribers REST-API: hvem har adgang, hvordan vpt_live_-nøgler fungerer, Bearer-godkendelse, anmodningsgrænser og fakturering i cyklusser.
VoxScribers REST-API giver dig mulighed for at sende lydfiler via URL og modtage den færdige transskription direkte i dit system, uden at skulle gennem webstedet. Den bruger de samme motorer og opkræver de samme cyklusser som transskriptioner foretaget i panelet.
Hvem kan bruge den
API'en er tilgængelig fra Professionel (R$ 39,90/måned). Adgang har: Professionel, Premium, alle virksomhedsplaner (månedlige og årlige) og de tilsvarende ældre planer. Hvis din konto ikke er berettiget, returnerer nøgleruterne fejlen 403 PLAN_NOT_ELIGIBLE.
API-nøgler
Opret nøglen
Kopiér hemmeligheden med det samme
vpt_live_... og vises kun én gang, når den oprettes. Vi gemmer kun en hash af den – den kan ikke gendannes senere.Opbevar den sikkert
Har du mistet nøglen? Der er ingen mulighed for at vise den igen. Revokér den gamle nøgle, og opret en ny. Kompromitterede nøgler bør revokeres straks.
Oprettelse af personlige nøgler har endnu ikke et dedikeret skærmbillede i panelet. Hvis din plan er berettiget, og du vil begynde at bruge API'en, så åbn en ticket, så aktiverer teamet adgangen sammen med dig.
Godkendelse
Hver anmodning sender nøglen i Authorization-headeren:
Authorization: Bearer vpt_live_SUA_CHAVE
En anmodning uden headeren returnerer 401 MISSING_API_KEY.
Send en lyd til transskription
Transskriptions-endpointet er på gatewayen api.voxscriber.com:
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer vpt_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
"webhook_url": "https://seusistema.com/webhooks/vozparatexto",
"formats": ["txt", "srt"]
}'
Accepterede felter i body: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER eller ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata og idempotency_key. Resultatet sendes til din webhook_url – se Webhooks og notifikationer.
Brug idempotency_key med et identificator fra dig (f.eks. optagelsens ID i dit system). Hvis den samme anmodning bliver sendt ved en fejl, bliver lyden ikke behandlet – eller faktureret – to gange.
Grænser
| Grænse | Værdi |
|---|---|
| Anmodninger pr. nøgle | 60 pr. minut |
| Lyd downloadet via URL | op til 500 MB (60 s timeout) |
| Lyd via passthrough (Premium-engine læser URL'en direkte) | op til 5 GB |
| Aktive nøgler pr. konto | 20 |
Sikkerhedsregler for URL'er: kun https, ingen omdirigeringer, og interne/private adresser blokeres. Lyd-URL'en skal være offentligt tilgængelig.
De tilgængelige eksportformater følger din plans gate, ligesom på webstedet – formater uden for planen returneres listet i exports_skipped.
Fakturering
API'en debiterer de samme cyklusser som en transskription foretaget på webstedet, afhængigt af den valgte engine (Standard/Whisper: 1 cyklus/min; Premium: 4 cyklusser/min; Ultra: 10 cyklusser/min). Der findes i dag ikke en månedlig kvote for kald eller et udgiftsloft pr. nøgle – du styrer forbruget via din cyklussaldo. Se Hvad er cyklusser, og hvor meget koster hvert minut?.
Ofte stillede spørgsmål
Jeg har mistet min API-nøgle. Hvordan får jeg den igen?
Det er ikke muligt at gendanne den – kun hashen gemmes i databasen. Revokér den mistede nøgle, og opret en ny.
Er API'en dyrere end webstedet?
Nej. Omkostningen i cyklusser er identisk, bestemt af engine og lydens varighed.
Kan jeg sende filen direkte i stedet for en URL?
Den primære kanal er via audio_url. Hvis dine lydfiler ikke har en offentlig URL, så kontakt supporten for at vurdere den bedste løsning for dit tilfælde.
Findes der OpenAPI-dokumentation?
Den offentlige spec på /.well-known/openapi.json dækker i dag kun de offentlige endpoints (statistik og delte transskriptioner). For resten, brug denne helpcenter og supporten.
Relaterede artikler
- Webhooks og notifikationer
- Automatisering med API'en
- Hvad er cyklusser, og hvor meget koster hvert minut?
- Eksportér til andre værktøjer
Ikke løst? Åbn en ticket – vores team svarer hurtigt.