Skicka ljud via URL och API
Så här importerar du ljud via en direkt URL i gränssnittet och skickar transkriberingar programmatiskt via API:et: berättigade planer, nycklar, autentisering, begränsningar och webhooks.
Förutom filuppladdning finns det två sätt att göra det utan att ha filen till hands: klistra in en medie-URL i gränssnittet (för alla användare) och skicka via API:et (för Profissional-planen och högre) – idealiskt för att integrera transkriberingen med system, PABX och automatiseringar.
1. Importera via URL i gränssnittet
På skärmen Ny transkription accepterar samma alternativ som tar emot YouTube även direkta URL:er till ljud-/videofiler (https). Servern laddar ner media och följer det vanliga flödet: val av språk (eller automatisk identifiering), planens motor och kostnad i cykler beroende på längd. Din plans gränser för längd och storlek gäller på samma sätt.
2. Transkriptions-API
Vem kan använda det
API:n är tillgänglig från och med Profissional-planen (R$ 39,90/mån) – inklusive Premium, företagsplaner och motsvarande äldre planer. På andra planer visas ett meddelande vid skapande av nyckel att planen inte är berättigad.
API-nycklar
- Tokenformat:
vpt_live_...; - Hemligheten visas endast en gång vid skapandet – förvara den i ett säkert ställe. Vi lagrar inte hemligheten, bara ett fingeravtryck av den;
- Upp till 20 aktiva nycklar per konto; du kan återkalla valfri nyckel när som helst;
- Hanteringsområdet för personliga nycklar i gränssnittet håller på att införas – om du inte hittar alternativet i ditt konto, öppna ett ärende så aktiverar vi det åt dig.
Hur ett anrop fungerar
Autentisering via header Authorization: Bearer vpt_live_.... I brödtexten anger du ljudets URL (audio_url, endast https), URL:en till din webhook för att ta emot resultatet, och eventuellt motor, språk, exportformat och idempotensnyckel.
- Rate limit: 60 förfrågningar per minut och nyckel;
- Storlek: ljud via URL upp till 500 MB för nedladdning på servern; med Premium-motorn kan URL:er upp till 5 GB läsas direkt av motorn utan mellanliggande nedladdning;
- Kostnad: samma cykler som på webbplatsen, baserat på längd och motor.
Ta emot resultatet (webhooks)
Resultatet levereras via en webhook signerad med HMAC-SHA256 (headers X-VPT-Signature och X-VPT-Event) – validera signaturen innan du litar på payloaden. Om din endpoint är nere skickar vi om med progressiv backoff: upp till 6 försök under ~24 timmar.
Vi accepterar endast https-URL:er och blockerar interna/privata adresser av säkerhetsskäl. Om ditt ljud ligger bakom autentisering, skapa en tillfälligt signerad URL i din lagring innan du anropar API:et.
Ingen publik URL till filen (t.ex. PABX-inspelningar)? Företags-API:et för granskning erbjuder en uppladdningsslutpunkt som returnerar en tillfällig uppladdnings-URL (giltig i 1 timme) – kontakta säljavdelningen om ditt användningsfall rör volymbaserad samtalsgranskning.
Vanliga frågor
Jag har förlorat nyckelhemligheten. Hur återställer jag den?
Det går inte att återställa – återkalla nyckeln och skapa en ny. Hemligheten finns bara vid skapandet.
Har API:et dokumentation?
Den fullständiga integrationsreferensen tillhandahålls tillsammans med aktiveringen av åtkomsten. Öppna ett ärende och berätta om ditt användningsfall.
Kan jag välja motor och språk i anropet?
Ja, båda är valfria parametrar – utan dem används planens standardmotor och språkidentifiering.
Tar API:et ut annan avgift än webbplatsen?
Nej. Samma cykler, samma regler (inklusive rabatt endast efter framgång).
Hur återkallar jag en äventyrad nyckel?
Återkalla den omedelbart i nyckelhanteringen (eller via supporten). Återkallelsen stänger av åtkomsten direkt.
Relaterade artiklar
Fick du inte svar på din fråga? Öppna ett ärende – ärenden med normal prioritet besvaras inom 24 timmar.