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.mp3Automazione 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
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
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
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
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
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

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
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
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
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.
23 lingue
Ogni voce può parlare in una di queste lingue.
