Send lyd via URL og API
Sådan importerer du lyd via URL direkte i grænsefladen, og hvordan du sender transskriptioner programmatisk via API'en: kvalificerede planer, nøgler, godkendelse, grænser og webhooks.
Ud over filupload er der to måder "uden fil i hånden": indsæt en medie-URL i grænsefladen (for alle brugere) og send via API'en (for planer fra Profissional og opefter) — ideelt til at integrere transskription i systemer, PABX og automatiseringer.
1. Importér via URL i grænsefladen
På skærmen Ny transskription accepterer den samme mulighed, der accepterer YouTube, også direkte URL'er til lyd-/videofiler (https). Serveren henter mediet og følger det normale flow: valg af sprog (eller automatisk genkendelse), planens motor og omkostning i cyklusser efter varighed. Din plans grænser for varighed og størrelse gælder på samme måde.
2. Transskriptions-API
Hvem kan bruge den
API'en er tilgængelig fra planen Profissional (R$ 39,90/måned) — inklusive Premium, virksomhedsplaner og tilsvarende ældre planer. På andre planer giver oprettelse af en nøgle besked om, at planen ikke er berettiget.
API-nøgler
- Token-format:
vpt_live_...; - Hemmeligheden vises kun én gang ved oprettelsen — opbevar den i et sikkert system. Vi gemmer ikke selve hemmeligheden, kun et fingeraftryk af den;
- Op til 20 aktive nøgler pr. konto; du kan tilbagekalde enhver nøgle når som helst;
- Området til administration af personlige nøgler i grænsefladen er under implementering — hvis du ikke kan finde muligheden på din konto, åbn en ticket, så aktiverer vi den for dig.
Hvordan et kald fungerer
Godkendelse via headeren Authorization: Bearer vpt_live_.... I brødteksten angiver du lydens URL (audio_url, kun https), URL'en til din webhook for at modtage resultatet, og valgfrit motor, sprog, eksportformater og idempotensnøgle.
- Rate limit: 60 anmodninger pr. minut pr. nøgle;
- Størrelse: lyd via URL på op til 500 MB til download på serveren; med Premium-motoren kan URL'er på op til 5 GB læses direkte af motoren uden mellemliggende download;
- Omkostning: de samme cyklusser som på hjemmesiden, efter varighed og motor.
Modtagelse af resultatet (webhooks)
Resultatet leveres via webhook signeret med HMAC-SHA256 (headers X-VPT-Signature og X-VPT-Event) — valider signaturen, før du stoler på payloaden. Hvis dit endpoint er nede, sender vi igen med progressivt tilbagetog: op til 6 forsøg over ~24 timer.
Vi accepterer kun https-URL'er og blokerer interne/private adresser af sikkerhedsmæssige årsager. Hvis din lyd ligger bag godkendelse, så generér en midlertidig signeret URL i dit storage, før du kalder API'en.
Ingen offentlig URL til filen (f.eks. PABX-optagelser)? Virksomheds-API'en til audit tilbyder et upload-endpoint, som returnerer en midlertidig upload-URL (gyldig i 1 time) — kontakt salg, hvis dit behov er volumen-audit af opkald.
Ofte stillede spørgsmål
Jeg har mistet nøglens hemmelighed. Hvordan gendanner jeg?
Det er ikke muligt at gendanne — tilbagekald nøglen, og opret en ny. Hemmeligheden findes kun på oprettelsestidspunktet.
Har API'en dokumentation?
Den fulde integrationsreference leveres sammen med aktiveringen af adgangen. Åbn en ticket og fortæl om dit brugsscenarie.
Kan jeg vælge motor og sprog i kaldet?
Ja, begge er valgfrie parametre — uden dem gælder planens standardmotor og sproggenkendelse.
Opkræver API'en anderledes end hjemmesiden?
Nej. Samme cyklusser, samme regler (inklusive rabat kun efter succes).
Hvordan tilbagekalder jeg en kompromitteret nøgle?
Tilbagekald den straks i nøgleadministrationen (eller via support). Tilbagekaldelsen afskærer adgangen med det samme.
Relaterede artikler
Fik du ikke svar på dit spørgsmål? Åbn en ticket — tickets med normal prioritet besvares inden for 24 timer.