Sviluppatore API
Integra la localizzazione Addavox nel tuo flusso di lavoro. Scegli la traduzione API per l'audio tradotto autonomo oppure il doppiaggio video API per la localizzazione video completa con sincronizzazione, controllo qualità e sottotitoli.
API Chiavi
Genera le chiavi API nell'app Addavox . Ogni chiave utilizza lo stesso piano e gli stessi minuti inclusi del tuo account.
Gestisci le chiavi APIURL di base:
https://api.addavox.com/api/v1
Intestazione di autorizzazione:
X- API -Chiave: LA_TUA_CHIAVE
Panoramica dei servizi
Due API per diverse esigenze di localizzazione.
- Punto finale
POST /api/v1/localize- Produzione
- audio sequenziale autonomo
- Lingue
- Un solo esemplare per richiesta.
- Controllo qualità
- Nessuno
Da $0.05/min
Visualizza i dettagli ↓- Punto finale
POST /api/v1/localize-video- Produzione
- Video + audio + sottotitoli per lingua
- Lingue
- Più unità su richiesta
- Controllo qualità
- Controllo qualità LLM incluso
- Revisione
- Invita i revisori tramite il link magico
Da $1.60/min per lingua
Tariffa annuale aziendale.
Visualizza i dettagli ↓Traduzione API
Endpoint singolo: POST /api/v1/localize — genera audio tradotto autonomo dal tuo contenuto sorgente.
Applicazione web vs questo API : quando si utilizza il prodotto Addavox nel browser, i processi di modifica dei segmenti e di localizzazione mantengono l'audio di anteprima su ciascun segmento e rimandano il programma mixato completo fino al download delle risorse dalla pagina del progetto. Questi endpoint v1 creano l'output unito come parte del processo, in modo che i client API possano recuperare i risultati senza una fase di esportazione separata.
Tu fornisci
- Fonte audio
- Lingua di origine + lingua di destinazione
Ci occupiamo
- Trascrizione
- Traduzione
- audio vocale corrispondente all'oratore
- Cucitura sequenziale
Da $0.08/min
Tariffa del piano aziendale. Vedi i prezzi →
Tu fornisci
- Fonte audio
- Trascrizione con indicazioni temporali per segmento
- Lingua di origine + lingua di destinazione
Ci occupiamo
- Traduzione
- Audio vocale corrispondente all'oratore
- Cucitura sequenziale
Da $0.06/min
Tariffa del piano aziendale. Vedi i prezzi →
Tu fornisci
- Fonte audio
- Trascrizione + traduzione con indicazioni temporali per segmento
Ci occupiamo
- audio vocale corrispondente all'oratore
- Cucitura sequenziale
Da $0.05/min
Tariffa del piano aziendale. Vedi i prezzi →
Come funziona
Formato di output
Il API produce un file audio sequenziale autonomo. Ogni segmento tradotto viene generato e unito in sequenza con brevi pause tra di essi. L'output non è allineato temporalmente alla sorgente originale: si tratta di un nuovo file audio pensato per essere ascoltato in modo indipendente.
Perché fornire la sorgente audio e i relativi timestamp?
L'audio sorgente e i timestamp dei segmenti (start_time, end_time) vengono utilizzati per identificare e abbinare la voce di ciascun oratore nella registrazione originale. Ciò consente all'audio generato di suonare come gli oratori originali. Questi timestamp non controllano la temporizzazione dell'output.
Nessun controllo qualità o corrispondenza della durata
A differenza del doppiaggio video, la traduzione API non esegue la riscrittura del testo, la regolazione del tempo o l'allineamento temporale. Questo la rende più veloce ed economica. Se hai bisogno di sincronizzare l'audio con il video originale a livello di fotogramma, utilizza il doppiaggio video API .
Esempi di codice
Doppiaggio video API
Endpoint: POST /api/v1/localize-video — localizzazione video completa con sincronizzazione, controllo qualità e sottotitoli.
I lavori avviati tramite questo API producono risultati per lingua al termine del lavoro. L'app Addavox nel browser utilizza lo stesso motore di localizzazione ma rimanda le risorse miste complete al flusso di download del progetto, salvo diversa indicazione.
Tu fornisci
- URL del video
- lingua di origine
- Lingue di destinazione (una o più)
Ci occupiamo
- separazione audio/video
- Trascrizione
- Traduzione
- Controllo qualità LLM
- Sintesi vocale
- Allineamento temporale
- Generazione dei sottotitoli
- Rendering video per lingua
Formato di output
Video, audio e sottotitoli per ogni lingua. È disponibile anche un file zip scaricabile contenente tutte le lingue. Gli URL firmati scadono dopo 24 ore.
Lavori multilingue
Una richiesta, più lingue. Il job principale genera job secondari per ogni lingua. Interroga il job principale per conoscere lo stato di ciascuna lingua. Valori di stato: in coda → in esecuzione → completato | fallito.
Flusso di lavoro del revisore
Invita i revisori umani tramite il API . Ogni revisore riceverà un'e-mail con un link magico per modificare la localizzazione in un editor web, senza bisogno di creare un account.
Esempi di codice
Consenso e autorizzazione
Tutte le richieste API devono includere un oggetto di consenso e un campo modalità di primo livello. Insieme, questi creano un record di attestazione per lavoro che conferma il possesso dei diritti necessari e dei consensi del relatore.
Il campo "modalità" determina la sintesi vocale: "voice_matched" utilizza la clonazione della voce dell'oratore, "standard" utilizza la sintesi vocale sintetica (TTS). Entrambe le modalità hanno lo stesso prezzo: la scelta è dettata esclusivamente dal consenso.
Modalità di riconoscimento vocale: è richiesto il pieno consenso.
Modalità standard — Solo diritti sui contenuti
Riferimento di campo
| Campo | Tipo | Necessario | Descrizione |
|---|---|---|---|
| mode | string | Livello superiore | voice_matched O standard |
| speaker_consent_obtained | boolean | solo voce corrispondente | Consenso esplicito da parte di interlocutori identificabili |
| content_rights_confirmed | boolean | Entrambe le modalità | Proprietà o licenza valida del contenuto |
| eula_accepted | boolean | Entrambe le modalità | Accetta il Contratto di Licenza con l'Utente Finale (EULA) Addavox |
| attested_by | string | Entrambe le modalità | Indirizzo e-mail o identificativo del responsabile |
| attested_at | ISO 8601 | Entrambe le modalità | Entro 24 ore dalla richiesta |
Codici di errore relativi al consenso
| AMD | Codice | Condizione |
|---|---|---|
| 403 | CONSENT_MISSING | Nessuna obiezione al consenso |
| 403 | CONSENT_INCOMPLETE | attested_by mancante o attested_at non valido |
| 403 | CONSENT_NOT_AFFIRMED | Diritti o EULA non confermati |
| 403 | CONSENT_EXPIRED | attestato_a più di 24 ore fa |
| 403 | SPEAKER_CONSENT_REQUIRED | corrispondenza vocale senza il consenso dell'oratore |
| 400 | INVALID_MODE | Valore della modalità non valido |
API Riferimento
Lo schema interattivo completo e gli endpoint aggiuntivi sono disponibili tramite Open API .
Punti terminali
| POST /localize | Localizzazione audio pre-tradotta/trascrizione parziale |
| POST /localize-video | Doppiaggio video completo (in più lingue) |
| GET /jobs/{job_id} | Stato lavorativo |
| GET /jobs/{job_id}/result | Risultati da consegnare (URL, file zip) |
| GET /jobs | Elenco delle offerte di lavoro |
| DELETE /jobs/{job_id} | Annulla lavoro |
| GET /account | Informazioni sull'account |
| GET /voices | Catalogo vocale TTS |
| GET /languages | Lingue supportate |
| POST /projects/{id}/reviewers | Invita il revisore |
| GET|POST /jobs/{id}/webhooks | Stato del webhook / riprova |
API Prezzi dei servizi
Tariffe al minuto in base al piano di abbonamento. Le tariffe riportate di seguito si riferiscono al piano Business annuale (sconto del 20%). Consulta la tabella completa per ogni piano e servizio.
Le tariffe del piano aziendale mostrano lo sconto annuale già applicato.
Gratuito
Doppiaggio video
Incluso (~min)
2 min
Tariffa base (annua)
/min
Sovrappeso
$4.00/min
API Servizi
Separazione audio
Traccia vocale proprietaria con riduzione del rumore
Tariffa base
$0.03/min
Sovrappeso
$0.04/min
Incluso (~min)
~— min
Rilevamento del genere
Classificazione di genere da voce e contesto
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Trascrizione (STT)
Deepgram, conversione da parlato a testo con diarizzazione
Tariffa base
$0.05/min
Sovrappeso
$0.06/min
Incluso (~min)
~— min
Traduzione
Google Traduttore
Tariffa base
$0.03/min
Sovrappeso
$0.04/min
Incluso (~min)
~— min
Sintesi vocale
Google TTS + altri fornitori
Tariffa base
$0.06/min
Sovrappeso
$0.08/min
Incluso (~min)
~— min
Corrispondenza vocale
Clonazione vocale proprietaria (tutto incluso)
Tariffa base
$0.08/min
Sovrappeso
$0.10/min
Incluso (~min)
~— min
Avviamento
Doppiaggio video
Incluso (~min)
10 min
Tariffa base (annua)
$2.80/min
Sovrappeso
$3.60/min
API Servizi
Separazione audio
Traccia vocale proprietaria con riduzione del rumore
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Rilevamento del genere
Classificazione di genere da voce e contesto
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Trascrizione (STT)
Deepgram, conversione da parlato a testo con diarizzazione
Tariffa base
$0.04/min
Sovrappeso
$0.05/min
Incluso (~min)
~— min
Traduzione
Google Traduttore
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Sintesi vocale
Google TTS + altri fornitori
Tariffa base
$0.05/min
Sovrappeso
$0.06/min
Incluso (~min)
~— min
Corrispondenza vocale
Clonazione vocale proprietaria (tutto incluso)
Tariffa base
$0.08/min
Sovrappeso
$0.10/min
Incluso (~min)
~— min
Creatore
Doppiaggio video
Incluso (~min)
30 min
Tariffa base (annua)
$2.64/min
Sovrappeso
$3.20/min
API Servizi
Trascrizione + Traduzione + Audio vocale
Traduzione completa API bundle
Tariffa base
$0.11/min
Sovrappeso
$0.13/min
Incluso (~min)
~— min
Traduzione + Audio vocale
Pacchetto traduzione + audio vocale
Tariffa base
$0.10/min
Sovrappeso
$0.11/min
Incluso (~min)
~— min
Solo audio vocale
Pacchetto solo audio vocale
Tariffa base
$0.08/min
Sovrappeso
$0.10/min
Incluso (~min)
~— min
Separazione audio
Traccia vocale proprietaria con riduzione del rumore
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Rilevamento del genere
Classificazione di genere da voce e contesto
Tariffa base
$0.01/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Trascrizione (STT)
Deepgram, conversione da parlato a testo con diarizzazione
Tariffa base
$0.03/min
Sovrappeso
$0.04/min
Incluso (~min)
~— min
Traduzione
Google Traduttore
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Sintesi vocale
Google TTS + altri fornitori
Tariffa base
$0.04/min
Sovrappeso
$0.05/min
Incluso (~min)
~— min
Corrispondenza vocale
Clonazione vocale proprietaria (tutto incluso)
Tariffa base
$0.06/min
Sovrappeso
$0.08/min
Incluso (~min)
~— min
Pro
Doppiaggio video
Incluso (~min)
120 min
Tariffa base (annua)
$1.99/min
Sovrappeso
$2.80/min
API Servizi
Trascrizione + Traduzione + Audio vocale
Traduzione completa API bundle
Tariffa base
$0.10/min
Sovrappeso
$0.11/min
Incluso (~min)
~— min
Traduzione + Audio vocale
Pacchetto traduzione + audio vocale
Tariffa base
$0.08/min
Sovrappeso
$0.10/min
Incluso (~min)
~— min
Solo audio vocale
Pacchetto solo audio vocale
Tariffa base
$0.06/min
Sovrappeso
$0.08/min
Incluso (~min)
~— min
Separazione audio
Traccia vocale proprietaria con riduzione del rumore
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Rilevamento del genere
Classificazione di genere da voce e contesto
Tariffa base
$0.01/min
Sovrappeso
$0.01/min
Incluso (~min)
~— min
Trascrizione (STT)
Deepgram, conversione da parlato a testo con diarizzazione
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Traduzione
Google Traduttore
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Sintesi vocale
Google TTS + altri fornitori
Tariffa base
$0.03/min
Sovrappeso
$0.04/min
Incluso (~min)
~— min
Corrispondenza vocale
Clonazione vocale proprietaria (tutto incluso)
Tariffa base
$0.05/min
Sovrappeso
$0.06/min
Incluso (~min)
~— min
Attività commerciale
Doppiaggio video
Incluso (~min)
500 min
Tariffa base (annua)
$1.60/min
Sovrappeso
$2.40/min
API Servizi
Trascrizione + Traduzione + Audio vocale
Traduzione completa API bundle
Tariffa base
$0.08/min
Sovrappeso
$0.10/min
Incluso (~min)
~— min
Traduzione + Audio vocale
Pacchetto traduzione + audio vocale
Tariffa base
$0.06/min
Sovrappeso
$0.08/min
Incluso (~min)
~— min
Solo audio vocale
Pacchetto solo audio vocale
Tariffa base
$0.05/min
Sovrappeso
$0.06/min
Incluso (~min)
~— min
Separazione audio
Traccia vocale proprietaria con riduzione del rumore
Tariffa base
$0.01/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Rilevamento del genere
Classificazione di genere da voce e contesto
Tariffa base
$0.01/min
Sovrappeso
$0.01/min
Incluso (~min)
~— min
Trascrizione (STT)
Deepgram, conversione da parlato a testo con diarizzazione
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Traduzione
Google Traduttore
Tariffa base
$0.02/min
Sovrappeso
$0.02/min
Incluso (~min)
~— min
Sintesi vocale
Google TTS + altri fornitori
Tariffa base
$0.02/min
Sovrappeso
$0.03/min
Incluso (~min)
~— min
Corrispondenza vocale
Clonazione vocale proprietaria (tutto incluso)
Tariffa base
$0.03/min
Sovrappeso
$0.05/min
Incluso (~min)
~— min
I minuti visualizzati sono equivalenti: il tuo credito è condiviso tra tutti i servizi. Utilizzando un servizio più economico, consumi meno crediti al minuto.