4 min di lettura Uploading Files

Inviare audio tramite URL e API

Come importare audio tramite URL direttamente nell'interfaccia e come inviare trascrizioni programmaticamente tramite API: piani idonei, chiavi, autenticazione, limiti e webhook.

Oltre al caricamento di file, ci sono due percorsi "senza file in mano": incollare un URL multimediale nell'interfaccia (per qualsiasi utente) e inviare tramite API (per i piani Profissional e superiori) — ideale per integrare la trascrizione con sistemi, PABX e automazioni.

1. Importare tramite URL nell'interfaccia

Nella schermata Nuova trascrizione, la stessa opzione che accetta YouTube accetta anche URL diretti di file audio/video (https). Il server scarica il supporto e segue il flusso normale: scelta della lingua (o rilevamento automatico), motore del piano e costo in cicli in base alla durata. Valgono gli stessi limiti di durata e dimensione del tuo piano.

2. API di trascrizione

Chi può usarla

L'API è disponibile a partire dal piano Profissional (R$ 39,90/mese) — inclusi Premium, piani aziendali e legacy equivalenti. Sugli altri piani, la creazione della chiave restituisce un errore che il piano non è idoneo.

Chiavi API

Formato del token: vpt_live_...;
Il segreto viene mostrato una sola volta, alla creazione — conservalo in un vault. Non conserviamo il segreto, solo una sua impronta digitale;
Fino a 20 chiavi attive per account; puoi revocare qualsiasi chiave in qualsiasi momento;
L'area di gestione delle chiavi personali nell'interfaccia è in fase di implementazione — se non trovi l'opzione nel tuo account, apri un ticket e la attiveremo per te.

Come funziona una chiamata

Autenticazione tramite header Authorization: Bearer vpt_live_.... Nel corpo, inserisci l'URL dell'audio (audio_url, solo https), l'URL del tuo webhook per ricevere il risultato e, opzionalmente, motore, lingua, formati di esportazione e chiave di idempotenza.

Rate limit: 60 richieste al minuto per chiave;
Dimensione: audio tramite URL fino a 500 MB per il download sul server; con il motore Premium, URL fino a 5 GB possono essere letti direttamente dal motore, senza download intermedio;
Costo: gli stessi cicli del sito, in base a durata e motore.

Ricevere il risultato (webhook)

Il risultato arriva tramite webhook firmato con HMAC-SHA256 (header X-VPT-Signature e X-VPT-Event) — valida la firma prima di fidarti del payload. Se il tuo endpoint non è raggiungibile, reinviamo con backoff progressivo: fino a 6 tentativi in ~24 ore.

Accettiamo solo URL https e blocchiamo gli indirizzi interni/privati per sicurezza. Se il tuo audio è protetto da autenticazione, genera un URL firmato temporaneo sul tuo storage prima di chiamare l'API.

Nessun URL pubblico per il file (es. registrazioni PABX)? L'API aziendale di audit offre un endpoint di upload che restituisce un URL di invio temporaneo (valido per 1 ora) — contatta le vendite se il tuo caso è l'audit di chiamate in volume.

Domande frequenti

Ho perso il segreto della chiave. Come posso recuperarlo?

Non è possibile recuperarlo: revoca la chiave e creane un'altra. Il segreto esiste solo al momento della creazione.

L'API ha documentazione?

Il riferimento completo per l'integrazione viene fornito insieme all'attivazione dell'accesso. Apri un ticket indicando il tuo caso d'uso.

Posso scegliere motore e lingua nella chiamata?

Sì, entrambi sono parametri opzionali — senza di essi valgono il motore predefinito del piano e il rilevamento della lingua.

L'API applica prezzi diversi dal sito?

No. Stessi cicli, stesse regole (incluso lo sconto solo dopo il successo).

Come revoco una chiave compromessa?

Revocala immediatamente nella gestione delle chiavi (o tramite supporto). La revoca interrompe l'accesso immediatamente.