Integrazione API di lettura vocale per siti WordPress

Di Editoriale VoceBlog · Aggiornato 2026-11-19

Questa pagina illustra l'integrazione API per la generazione automatica di audio in WordPress, pensata per freelance e sviluppatori che gestiscono blog e siti web. Scopri come automatizzare la lettura vocale dei contenuti senza dipendere da provider esterni, garantendo un flusso di lavoro tecnico e scalabile.

Ottieni accesso a un'infrastruttura compatibile con lo schema di richiesta OpenAI, con 8 voci sintetiche, 23 lingue e una struttura di prezzo trasparente a consumo. Configura rapidamente le chiavi API, gestisci i file audio generati su richiesta e integra facilmente la sintesi vocale nei tuoi progetti WordPress.

Integrazione API di lettura vocale per siti WordPress

Domande frequenti

Cos'è un'API di lettura vocale per WordPress?

È un'infrastruttura cloud che converte testo in file audio tramite endpoint POST. Invii il testo e ricevi un file audio, senza dipendenze da provider esterni. Funziona con SDK OpenAI cambiando il base_url, permettendo automazione diretta nei siti WordPress per la lettura vocale dei contenuti.

Come funziona l'integrazione tecnica?

Si utilizza l'endpoint POST /v1/audio/speech con autenticazione Bearer. Il corpo della richiesta include modello, testo, voce e formato. È compatibile con gli SDK ufficiali OpenAI modificando semplicemente il base_url. Supporta anche gli endpoint GET per voci e modelli, garantendo integrazione standardizzata.

Quali formati audio sono supportati?

Il servizio supporta cinque formati: mp3, wav, opus, flac e pcm. È possibile specificare il formato desiderato nel campo response_format della richiesta JSON. Questa flessibilità permette di scegliere il codec più adatto alle esigenze di archiviazione o riproduzione del sito WordPress.

Quali lingue sono disponibili?

Sono supportate 23 lingue tra cui inglese, italiano, tedesco, spagnolo, francese, cinese, giapponese e arabo. Ogni voce può parlare qualsiasi lingua supportata. Se non specificato, il sistema indovina la lingua; per testi latini non inglesi, è consigliato impostare il campo language esplicitamente.

Quanto costa il servizio per carattere?

Il costo è di $10 per 1 milione di caratteri, ovvero $0,01 per 1.000 caratteri. Spazi e punteggiatura contano come caratteri. Le richieste fallite sono gratuite e l'addebito viene restituito integralmente. Non ci sono piani mensili né costi fissi, solo un pagamento a consumo.

Come funziona il pagamento con USDT?

I pagamenti avvengono esclusivamente tramite USDT sulla rete TRON (TRC-20). Il minimo è di $5 e il credito viene accreditato automaticamente entro minuti dal trasferimento. Non sono accettate carte o PayPal. Il saldo non ha scadenza e non ci sono fatture con IVA incluse.

I dati inviati vengono usati per l'addestramento?

No, il testo di input viene utilizzato solo per produrre l'audio e non per l'addestramento dei modelli. L'audio generato viene restituito nella risposta e non viene memorizzato. Vengono conservati solo i metadati della richiesta (ora, caratteri, stato) per fini di fatturazione.

È possibile clonare la propria voce?

No, non offriamo clonazione vocale personalizzata né caricamento di voci proprie. Le 8 voci disponibili sono preset basati su registrazioni con licenza. Non è possibile progettare nuove voci o aggiungere emozioni personalizzate. La clonazione su misura non è una funzionalità attualmente disponibile nel servizio.

Qual è il limite di caratteri per richiesta?

Ogni richiesta può contenere fino a 4096 caratteri nel campo input. Superato questo limite, è necessario suddividere il testo in parti più piccole. Il sistema non gestisce automaticamente testi molto lunghi in un'unica chiamata; la suddivisione deve essere gestita dall'applicazione o dallo script.

Come si gestiscono i testi lunghi?

È necessario suddividere il testo in parti da massimo 4096 caratteri e inviare richieste separate. Successivamente, i file audio generati devono essere uniti. La velocità di generazione è circa in tempo reale, quindi testi lunghi richiederanno tempo proporzionale alla durata audio risultante.

Quali sono i limiti di velocità (rate limit)?

Le richieste fallite sono gratuite. Se la sintesi non riesce, l'addebito viene restituito integralmente.

Le richieste fallite vengono addebitate?

Non offriamo garanzie di uptime né contratti enterprise. Il servizio è fornito 'così com'è' senza SLA formali. Non ci sono certificazioni specifiche. Per il supporto, si utilizza esclusivamente l'email, senza numeri di telefono o chat dal vivo.

C'è una garanzia di uptime disponibile?

Ogni account ha una sola chiave attiva. È possibile emettere una nuova chiave in qualsiasi momento dal pannello di controllo. La vecchia chiave viene disattivata immediatamente non appena viene generata quella nuova. La chiave corrente è visibile nella pagina /get-api-key/ dopo l'accesso.

Prima richiesta

curl

curl https://api.11lab.info/v1/audio/speech \
  -H "Authorization: Bearer $TTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
  --output hello.mp3

Automazione audio per blog WordPress

Illustrazione dell'onda sonora per: Automazione audio per blog WordPress

La generazione audio su richiesta permette di convertire i contenuti del blog in file audio al momento della pubblicazione. Non è necessario pre-generare tutti i file, riducendo lo spazio di archiviazione e garantendo che l'audio rifletta sempre il testo aggiornato.

L'integrazione tecnica sfrutta un endpoint standardizzato compatibile con gli SDK ufficiali. La configurazione richiede solo l'aggiornamento del base_url e l'inserimento della chiave API, consentendo un flusso di lavoro automatizzato senza dipendenze da provider esterni.

Generazione audio su richiesta

Generazione audio su richiesta

Ogni modifica al contenuto del blog può innescare una chiamata API per generare l'audio corrispondente. Questo approccio elimina la necessità di mantenere library audio statiche e permette di servire contenuti vocali sempre aggiornati.

Integrazione tecnica semplice

L'endpoint POST /v1/audio/speech accetta JSON standard, rendendo l'integrazione con plugin WordPress o temi personalizzati possibile. Gli sviluppatori possono utilizzare le stesse librerie SDK già note per gestire le richieste e ricevere i file audio.

  • Endpoint compatibile con lo schema di richiesta OpenAI
  • Configurazione rapida del base_url
  • Autenticazione tramite Bearer token

Gestione automatica dei file

L'API restituisce direttamente il file audio nella risposta, che può essere memorizzato o servito dinamicamente dal sito. Non è richiesta la gestione manuale dei formati, poiché il file è generato al volo.

Compatibilità con gli standard esistenti

Illustrazione dell'onda sonora per: Compatibilità con gli standard esistenti

L'endpoint dell'API segue la medesima struttura delle richieste per il modello tts-1 di OpenAI, garantendo interoperabilità immediata con le infrastrutture esistenti. Il metodo POST su /v1/audio/speech accetta un corpo JSON standardizzato, riducendo la complessità di integrazione per i team di sviluppo.

Endpoint compatibile con OpenAI

La struttura della richiesta è identica a quella dell'endpoint OpenAI. È sufficiente inviare il testo, il modello (tts-1 o tts-1-hd) e le impostazioni vocali in formato JSON. Questo standardizzazione elimina la necessità di parser personalizzati per le risposte audio.

Utilizzo degli SDK ufficiali

Gli SDK ufficiali di OpenAI sono compatibili con la nostra API modificando il base_url. È possibile riutilizzare le librerie già integrate nei progetti WordPress o nei plugin di automazione, modificando semplicemente l'indirizzo di base. Questo accelera lo sviluppo e riduce i tempi di debug.

  • Compatibilità con librerie OpenAI standard
  • Riutilizzo del codice esistente
  • Nessuna dipendenza da SDK proprietari

Semplice configurazione base_url

L'integrazione richiede solo la modifica della proprietà base_url verso https://api.11lab.info/v1. Non sono necessari adattamenti alle chiamate HTTP o alla gestione dei token. La chiave API viene passata nell'header Authorization come standard.

Voci sintetiche professionali

Illustrazione dell'onda sonora per: Voci sintetiche professionali

La nostra API offre otto preset vocali distinti, disponibili in genere maschile e femminile. Ogni voce è selezionata per adattarsi a diversi contesti editoriali, dalla narrazione calda alla conversazione amichevole, garantendo coerenza sonora in tutti i contenuti del tuo blog WordPress.

8 preset vocali distinti

Le voci includono Aria, Nova, Luna e Sage per registri femminili, e Felix, Milo, Atlas e Orion per quelli maschili. Questa varietà permette di differenziare i contenuti audio del sito senza dover gestire registrazioni multiple.

  • Aria: narratrice calda e chiara
  • Nova: voce luminosa e vivace
  • Luna: morbida, ideale per storie
  • Sage: calmo, per istruzioni
  • Felix: energico, promozionale
  • Milo: amichevole, conversazionale
  • Atlas: neutro, per notizie
  • Orion: profonda, per documentari

Qualità audio garantita

Le voci sono basate su registrazioni licenziate da LibriTTS-R (CC BY 4.0), tratte da audiolibri di pubblico dominio. Ogni generazione restituisce file audio in formati standardizzati come MP3, WAV, OPUS, FLAC o PCM, pronti per l'embed nei template WordPress.

Watermark invisibile integrato

Ogni file audio generato contiene un watermark inudibile che ne certifica la natura sintetica. Questo elemento è inserito automaticamente dal motore di sintesi e non richiede configurazione aggiuntiva né modifica il flusso di pubblicazione.

Copertura linguistica estesa

Illustrazione dell'onda sonora per: Copertura linguistica estesa

L'API supporta 23 lingue specifiche, tra cui inglese, italiano, spagnolo, francese, tedesco, cinese, giapponese, arabo, russo, hindi, danese, olandese, finlandese, greco, ebraico, coreano, malese, norvegese, polacco, portoghese, swahili, svedese e turco. Le voci sono progettate per una pronuncia accurata e naturale in tutti i contesti narrativi e informativi.

Il sistema rileva automaticamente la lingua dal testo di input, assegnando l'inglese come default per il testo latino. È possibile sovrascrivere il rilevamento impostando esplicitamente il campo language per garantire la corretta sintesi.

23 lingue supportate

La copertura linguistica include 23 lingue specifiche, garantendo versatilità per contenuti blog multilingue.

  • Arabo, Cinese, Danese, Olandese, Inglese
  • Finlandese, Francese, Tedesco, Greco, Ebraico
  • Hindi, Italiano, Giapponese, Coreano, Malese
  • Norvegese, Polacco, Portoghese, Russo, Spagnolo
  • Swahili, Svedese, Turco

Rilevamento automatico lingua

Il motore analizza lo script di input per determinare la lingua target. Questo processo è trasparente e richiede nessuna configurazione aggiuntiva per testi monolingua standard.

Specifica lingua opzionale

Per testi in latino-script non inglesi, si consiglia di impostare il parametro language esplicitamente. Questo evita ambiguità e assicura che la voce sintetizzi con l'accento e la pronuncia corretti.

Struttura di prezzo trasparente

Illustrazione dell'onda sonora per: Struttura di prezzo trasparente

La struttura tariffaria è basata esclusivamente sui caratteri effettivi inviati all'API, inclusi spazi e punteggiatura. Il costo è di $0,01 per ogni 1.000 caratteri, ovvero $10 per milione di caratteri. Non esistono canoni fissi né costi di attivazione; paghi solo per il consumo effettivo di caratteri sintetizzati.

Costo per carattere

La fatturazione è lineare e prevedibile: ogni richiesta che supera la sintesi genera un addebito proporzionale alla lunghezza del testo. Le richieste fallite non vengono addebitate, garantendo che il costo rifletta esclusivamente gli audio prodotti con successo.

Nessun costo fisso mensile

Non sono previsti piani tariffari mensili, abbonamenti o costi minimi di permanenza. Il saldo rimane disponibile fino all'esaurimento e non scade. Puoi interrompere l'uso in qualsiasi momento senza penali, ottimizzando le spese per progetti a volume variabile.

Pagamenti con criptovaluta

I ricarichi avvengono esclusivamente tramite USDT su rete TRON (TRC-20), con un minimo di ricarica di $5. I fondi vengono accreditati automaticamente nel tuo account entro pochi minuti dal trasferimento. Non accettiamo carte di credito, PayPal o fatture con IVA.

Per iniziare, la registrazione con Google offre un credito gratuito iniziale di $0,50 (circa 50.000 caratteri), valido per 7 giorni. Questo permette di testare l'infrastruttura senza impegno finanziario immediato.

  • Minimo ricarica: $5
  • Network: TRON (TRC-20)
  • Credito iniziale: $0,50 con login Google
Struttura di prezzo trasparente

Performance e limiti tecnici

Illustrazione dell'onda sonora per: Performance e limiti tecnici

La generazione audio richiede tempo variabile in base alla lunghezza del testo. I testi lunghi vengono elaborati in tempo reale, circa 25 caratteri al secondo, mentre le frasi brevi richiedono alcuni secondi. Le richieste vengono elaborate in sequenza e, sotto carico, possono subire code di attesa.

Velocità di generazione

I tempi di elaborazione dipendono dalla lunghezza dell'input e dal carico del server. Non vi sono garanzie di latenza fissa poiché l'elaborazione avviene in coda.

Limiti di frequenza

Ogni chiave API è soggetta a un limite di 60 richieste al minuto. Per gli account senza ricarica attiva, il limite è ridotto a 10 richieste al minuto.

Gestione testi lunghi

Il sistema accetta fino a 4096 caratteri per richiesta. Per testi più lunghi, è necessario suddividere l'input e unire i file audio risultanti.

Privacy e trattamento dati

Illustrazione dell'onda sonora per: Privacy e trattamento dati

La nostra infrastruttura API garantisce che il testo inviato non venga utilizzato per addestrare i modelli di intelligenza artificiale. Il testo viene elaborato esclusivamente per generare il file audio richiesto e non entra a far parte del dataset di training del modello sottostante.

Nessun utilizzo per training

La privacy dei dati è strutturata per isolare il processo di sintesi vocale dall'apprendimento automatico. I contenuti inviati per la generazione audio restano confinati alla singola esecuzione della richiesta.

Dati di richiesta conservati

Per garantire la correttezza della fatturazione e la tracciabilità dei servizi, conserviamo i metadati della richiesta. Questi includono timestamp, numero di caratteri elaborati e stato della richiesta, senza includere il contenuto testuale generico.

Audio non memorizzato

I file audio generati vengono restituiti nella risposta immediata e non vengono archiviati sui nostri server dopo la consegna. L'infrastruttura mantiene solo i dati necessari alla verifica amministrativa del servizio.

Supporto tecnico dedicato

Illustrazione dell'onda sonora per: Supporto tecnico dedicato

Supportiamo gli sviluppatori WordPress e i freelance attraverso assistenza tecnica accessibile esclusivamente via email.

La documentazione API è completa e aggiornata, coprendo ogni endpoint e parametro richiesto per un'integrazione fluida nei sistemi di gestione dei contenuti.

Assistenza via email

Non offriamo chat dal vivo né numeri di telefono. Ogni richiesta viene gestita per iscritto, permettendo di allegare log e dettagli tecnici specifici del vostro ambiente WordPress.

Documentazione API

La guida tecnica descrive nel dettaglio la struttura delle richieste JSON e i formati di risposta supportati, facilitando l'integrazione diretta senza ambiguità.

Chiavi di autenticazione

Ogni account dispone di una chiave Bearer univoca. In caso di necessità, è possibile emetterne una nuova immediatamente, revocando l'accesso alla precedente in modo permanente.

  • Una sola chiave attiva per account

Demo e configurazione rapida

Illustrazione dell'onda sonora per: Demo e configurazione rapida

Per verificare immediatamente la funzionalità dell'API, è sufficiente inviare una richiesta di test tramite la dashboard. L'interfaccia mostra lo stato della chiave e il saldo residuo, permettendo di validare la connessione prima dell'integrazione nei temi WordPress.

Test immediato dell'API

L'accesso alla pagina /get-api-key/ fornisce i dati di connessione necessari. È possibile effettuare una richiesta di prova per confermare che il formato JSON sia accettato correttamente dal server.

  • Validazione istantanea della chiave API
  • Verifica del saldo e dei crediti disponibili

Esempi di codice curl

La documentazione include snippet pronti all'uso per l'endpoint POST /v1/audio/speech. Gli sviluppatori possono testare la generazione audio modificando solo il campo input nel corpo della richiesta.

Verifica disponibilità voci

Prima dell'integrazione, è possibile elencare i 8 preset vocali e le lingue supportate tramite l'endpoint GET /v1/voices. Questo garantisce la selezione corretta del voice id per il progetto.

Ascolta le 8 voci

Ogni campione sottostante è stato generato da questa API utilizzando la stessa frase. Utilizza un conteggio preciso per prevedere il costo esatto della sintesi audio.

Avatar della voce aria
ariafemminile
Avatar della voce nova
novafemminile
Avatar della voce luna
lunafemminile
Avatar della voce sage
sagefemminile
Avatar della voce felix
felixmaschile
Avatar della voce milo
milomaschile
Avatar della voce atlas
atlasmaschile
Avatar della voce orion
orionmaschile

23 lingue

Ogni voce può parlare in una di queste lingue.

Fonti e ulteriori letture

  1. Wikipedia
  2. openai-node on GitHub
  3. ISO 639 language codes
  4. openai-python on GitHub
  5. curl documentation
  6. W3C WAI: making audio and video accessible
  7. OpenAI API reference: create speech
  8. MDN: Web Speech API
  9. Creative Commons Attribution 4.0
  10. IETF RFC 7845: Ogg Opus
  11. Node.js documentation
  12. LibriVox public-domain audiobooks

Altro su questo sito