Send lyd via URL og API
Hvordan importere lyd via direkte URL i grensesnittet og hvordan sende transkripsjoner programmatisk via API: kvalifiserende planer, nøkler, autentisering, grenser og webhooks.
I tillegg til filopplasting finnes det to måter «uten fil i hånden»: å lime inn en medie-URL i grensesnittet (for alle brukere) og å sende via API (for Profissional-planer og oppover) — ideelt for å integrere transkripsjon i systemer, PABX og automatiseringer.
1. Importer via URL i grensesnittet
På skjermen for Ny transkripsjon godtar det samme alternativet som aksepterer YouTube direktelenker til lyd-/videofiler (https). Serveren laster ned mediet og følger den vanlige flyten: valg av språk (eller automatisk gjenkjenning), motoren for planen din og kostnad i sykluser basert på varighet. Din plans grenser for varighet og størrelse gjelder på samme måte.
2. Transkripsjons-API
Hvem kan bruke det
API-en er tilgjengelig fra Profissional-planen (R$ 39,90/måned) — inkludert Premium, bedriftsplaner og tilsvarende eldre planer. På andre planer får du beskjed om at planen ikke er kvalifisert når du prøver å opprette en nøkkel.
API-nøkler
- Token-format:
vpt_live_...; - Hemmeligheten vises kun én gang ved oppretting — oppbevar den i et sikkert system. Vi lagrer ikke hemmeligheten, kun et digitalt fingeravtrykk av den;
- Opptil 20 aktive nøkler per konto; du kan tilbakekalle hvilken som helst når som helst;
- Området for administrasjon av personlige nøkler i grensesnittet er under implementering — hvis du ikke finner alternativet på kontoen din, åpne en billett så aktiverer vi den for deg.
Hvordan et kall fungerer
Autentisering via headeren Authorization: Bearer vpt_live_.... I brødteksten angir du lydens URL (audio_url, kun https), URL-en til webhooken din for å motta resultatet, og valgfritt motor, språk, eksportformater og idempotensnøkkel.
- Rate limit: 60 forespørsler per minutt per nøkkel;
- Størrelse: lyd via URL opptil 500 MB for nedlasting på serveren; med Premium-motoren kan URL-er opptil 5 GB leses direkte av motoren, uten mellomlagret nedlasting;
- Kostnad: de samme syklusene som på nettsiden, basert på varighet og motor.
Motta resultatet (webhooks)
Resultatet kommer via en webhook signert med HMAC-SHA256 (headere X-VPT-Signature og X-VPT-Event) — valider signaturen før du stoler på innholdet. Hvis endepunktet ditt er utilgjengelig, sender vi på nytt med progressivt økende ventetid: opptil 6 forsøk i løpet av ~24 timer.
Vi godtar kun https-URL-er og blokkerer interne/private adresser av sikkerhetshensyn. Hvis lyden din ligger bak autentisering, generer en midlertidig signert URL i lagringsløsningen din før du kaller API-en.
Ingen offentlig URL til filen (f.eks. PABX-opptak)? Bedrifts-API-en for revisjon tilbyr et opplastingsendepunkt som returnerer en midlertidig opplastings-URL (gyldig i 1 time) — kontakt salg hvis bruksområdet ditt er volumrevisjon av samtaler.
Vanlige spørsmål
Jeg mistet nøkkelens hemmelighet. Hvordan får jeg den tilbake?
Det er ikke mulig å gjenopprette — tilbakekall nøkkelen og opprett en ny. Hemmeligheten eksisterer bare i opprettelsesøyeblikket.
Har API-en dokumentasjon?
Den fullstendige integrasjonsreferansen leveres sammen med aktiveringen av tilgangen. Åpne en billett og oppgi bruksområdet ditt.
Kan jeg velge motor og språk i kallet?
Ja, begge er valgfrie parametre — uten dem gjelder planens standardmotor og språkgjenkjenning.
Tar API-en andre priser enn nettstedet?
Nei. Samme sykluser, samme regler (inkludert rabatt kun etter vellykket resultat).
Hvordan tilbakekaller jeg en kompromittert nøkkel?
Tilbakekall den umiddelbart i nøkkeladministrasjonen (eller via støtte). Tilbakekallingen stopper tilgangen øyeblikkelig.
Relaterte artikler
Fikk du ikke svar? Åpne en billett — billetter med normal prioritet besvares innen 24 timer.