Transkripsjons-API: Oversikt, autentisering og grenser

Q: Kan jeg sende filen direkte i stedet for en URL?

Hovedkanalen er via audio_url . Hvis lydene dine ikke har en offentlig URL, kontakt kundestøtte for å vurdere den beste flyten for ditt tilfelle.

Q: Finnes det OpenAPI-dokumentasjon?

Den offentlige spesifikasjonen på /.well-known/openapi.json dekker per i dag bare de offentlige endepunktene (statistikk og delte transkripsjoner). For resten, bruk dette hjelpesenteret og kundestøtte.

Hvordan bruke VoxScribers REST-API: hvem har tilgang, hvordan vpt_live_-nøkler fungerer, Bearer-autentisering, forespørselsgrenser og fakturering per syklus.

VoxScribers REST-API lar deg sende lyd via URL og motta den ferdige transkripsjonen direkte i systemet ditt, uten å gå via nettsiden. Den bruker de samme motorene og belaster de samme syklusene som transkripsjoner gjort i panelet.

Hvem kan bruke det

API-en er tilgjengelig fra og med Profissional (R$ 39,90/måned). Følgende har tilgang: Profissional, Premium, alle bedriftsplanene (månedlige og årlige) og tilsvarende eldre planer. Hvis kontoen din ikke er kvalifisert, returnerer nøkkelendepunktene feilen 403 PLAN_NOT_ELIGIBLE.

API-nøkler

Opprett nøkkelen

Hver konto kan ha opptil 20 aktive nøkler, hver med et identifikasjonsnavn.

Kopier hemmeligheten med en gang

Nøkkelen har formatet vpt_live_... og vises bare én gang, når den opprettes. Vi lagrer bare en hash av den — det er ikke mulig å hente den frem igjen senere.

Oppbevar den sikkert

Lagre den i en miljøvariabel eller i et hemmelighetshvelv. Versjoner aldri nøkkelen i kode.

Mistet nøkkelen? Det er ikke mulig å vise den på nytt. Tilbakekall den gamle nøkkelen og opprett en ny. Kompromitterte nøkler må tilbakekalles umiddelbart.

Oppretting av personlige nøkler har ennå ikke en dedikert skjerm i panelet. Hvis planen din er kvalifisert og du vil begynne å bruke API-en, åpne en billett så aktiverer teamet tilgangen sammen med deg.

Autentisering

Hver forespørsel tar med nøkkelen i Authorization-headeren:

Authorization: Bearer vpt_live_SUA_CHAVE

Forespørsel uten headeren returnerer 401 MISSING_API_KEY.

Sende lyd for transkribering

Transkripsjonsendepunktet ligger 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"]
  }'

Godkjente felt i bodyen: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER eller ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata og idempotency_key. Resultatet kommer til webhook_url din — se Webhooks og varsler.

Bruk idempotency_key med en identifikator du velger (f.eks. ID-en til opptaket i systemet ditt). Hvis samme forespørsel sendes på nytt ved en feil, blir ikke lyden behandlet – eller fakturert – to ganger.

Grenser

Grense	Verdi
Forespørsler per nøkkel	60 per minutt
Nedlastet lyd per URL	opptil 500 MB (60 s timeout)
Lyd via passthrough (Premium-motor leser URL-en direkte)	opptil 5 GB
Aktive nøkler per konto	20

Sikkerhetsregler for URL-er: kun https, ingen omdirigeringer, og interne/private adresser er blokkert. Lyd-URL-en må være offentlig tilgjengelig.

Tilgjengelige eksportformater følger planens tilgangsnivå, på samme måte som på nettsiden — formater utenfor planen returneres som exports_skipped.

Fakturering

API-en belaster de samme syklusene som en transkripsjon gjort på nettsiden, avhengig av valgt motor (Standard/Whisper: 1 syklus/min; Premium: 4 sykluser/min; Ultra: 10 sykluser/min). Det finnes i dag ingen månedlig kvote for kall eller noe utgiftstak per nøkkel — kontroller forbruket med syklussaldoen din. Se Hva er sykluser og hva koster hvert minutt.

FAQ

Jeg mistet API-nøkkelen min. Hvordan får jeg den tilbake?

Det er ikke mulig å hente den frem igjen — bare hashen ligger i databasen. Tilbakekall den mistede nøkkelen og opprett en ny.

Koster API-en mer enn nettsiden?

Nei. Kostnaden i sykluser er identisk, og bestemmes av motoren og lydens varighet.

Kan jeg sende filen direkte i stedet for en URL?

Hovedkanalen er via audio_url. Hvis lydene dine ikke har en offentlig URL, kontakt kundestøtte for å vurdere den beste flyten for ditt tilfelle.

Finnes det OpenAPI-dokumentasjon?

Den offentlige spesifikasjonen på /.well-known/openapi.json dekker per i dag bare de offentlige endepunktene (statistikk og delte transkripsjoner). For resten, bruk dette hjelpesenteret og kundestøtte.

Relaterte artikler

Ikke løst? Åpne en billett — teamet vårt svarer raskt.

Webhooks: HMAC-signatur, gjenleveringer og beste praksis