Guida pratica all'integrazione API di lettura vocale

Di Editoriale VoceBlog · Aggiornato 2026-11-19

Questa guida tecnica descrive l'integrazione della nostra API Text-to-Speech in ambienti WordPress, destinata specificamente a freelancer e sviluppatori che gestiscono blog. Scopri come automatizzare la generazione di file audio per articoli e newsletter, eliminando le dipendenze da provider esterni e garantendo un flusso di lavoro continuo e prevedibile.

Analizziamo la configurazione dell'endpoint, la selezione delle voci e la gestione dei costi con dati concreti. Troverai esempi di codice PHP pronti per l'uso, strategie per ottimizzare le richieste e criteri chiari per la conformità dei dati, essenziali per mantenere l'infrastruttura audio del tuo sito efficiente e priva di sorprese nei costi.

Guida pratica all'integrazione API di lettura vocale

Domande frequenti

Qual è il metodo di integrazione migliore?

Utilizza la chiamata POST a https://api.11lab.info/v1/audio/speech con il formato JSON standard. Puoi integrarla tramite PHP o JavaScript nel tuo tema WordPress. Invia il testo e ricevi il file audio nella risposta. Questa infrastruttura API diretta garantisce controllo totale senza dipendenze da provider esterni per la generazione audio.

Devo usare un plugin WordPress esistente?

Non è necessario. Puoi implementare l'integrazione direttamente nel codice del tema o tramite un plugin personalizzato. Utilizza le SDK ufficiali OpenAI cambiando il base_url o le chiamate HTTP native. Questo approccio riduce la complessità e garantisce che l'automazione sia gestita esclusivamente dalla tua infrastruttura.

Come calcolare i costi prima del lancio?

Il costo è di $0.01 per 1.000 caratteri, inclusi spazi e punteggiatura. Moltiplica la lunghezza media dei tuoi articoli per questo tasso. Le richieste fallite sono gratuite. Non ci sono costi fissi mensili. Monitora il pannello di controllo per verificare il saldo residuo e i caratteri consumati in tempo reale.

Quali voci usare per articoli tecnici?

Per contenuti tecnici, consigliamo le voci 'sage' (calma, istruzione) o 'atlas' (neutra, notizie). Entrambe offrono chiarezza e neutralità adatte alla lettura di dati complessi. Supportano tutte le 23 lingue disponibili. La voce 'atlas' è ideale per aggiornamenti neutri, mentre 'sage' guida l'utente attraverso procedure.

Come gestire l'audio su mobile?

Restituisci i file audio nei formati supportati come mp3, opus o wav. Questi formati sono ampiamente compatibili con i player HTML5 standard sui dispositivi mobili. Non offriamo streaming WebSocket, quindi il file deve essere scaricato o bufferizzato. Assicurati che il tuo tema supporti l'elemento audio standard del browser.

Posso usare le stesse voci per tutti i blog?

Sì, puoi utilizzare le stesse 8 voci predefinite per tutti i tuoi blog o siti web. Non ci sono limiti sul numero di istanze. Ogni account ha una chiave API attiva che può generare audio per domini diversi. La coerenza del brand audio è garantita indipendentemente dal sito di destinazione.

Come gestisco la cache dei file audio?

I file audio generati non vengono memorizzati nel nostro server dopo la consegna. Devi gestirne la cache sul tuo server o CDN. Salva i file generati localmente o su storage esterno. Poiché il testo è l'unico input, puoi riutilizzare l'audio per lo stesso testo esatto senza nuove chiamate API, riducendo i costi.

Qual è il limite di richieste simultanee?

Il limite è di 60 richieste al minuto per chiave API. Le richieste vengono elaborate in sequenza. In caso di carico elevato, le richieste possono accodarsi. Non offriamo garanzie SLA per la latenza. Per carichi elevati, considera di generare gli audio in anticipo e memorizzarli nella cache.

Devo preoccuparmi del rate limit?

Sì, il limite è di 60 richieste al minuto. Prima del primo caricamento, è limitato a 10 richieste al minuto. Monitora il tuo utilizzo dal pannello di controllo. Se superi il limite, le richieste potrebbero subire ritardi. Per blog con traffico elevato, pianifica la generazione audio in momenti di minor carico.

Come cambio chiave API senza downtime?

Puoi emettere una nuova chiave API in qualsiasi momento dal pannello di controllo. La vecchia chiave viene disattivata immediatamente. Per evitare downtime, aggiorna la chiave nel tuo codice WordPress prima della generazione della nuova chiave. Assicurati che l'applicazione utilizzi sempre la chiave attiva valida.

I file audio occupano spazio sul server?

I file audio restituiti dalla risposta non vengono memorizzati dal nostro servizio. Occupano spazio solo se decidi di salvarli sul tuo server o storage. Il formato scelto (mp3, wav, ecc.) influisce sulle dimensioni. Non c'è un costo di storage incluso nel prezzo per caratteri. Gestisci lo spazio in base alle tue esigenze.

Posso usare l'API per podcast?

Sì, l'API è adatta per generare audio per podcast. Puoi inviare testi fino a 4096 caratteri per richiesta. Per episodi più lunghi, dividi il testo in parti e unisci i file audio. I formati supportati includono mp3 e wav, ideali per la distribuzione podcast. La velocità è regolabile tra 0.25 e 4.0.

Qual è la differenza tra tts-1 e tts-1-hd?

Entrambi i modelli utilizzano lo stesso motore e hanno lo stesso prezzo di $0.01 per 1.000 caratteri. La differenza risiede nella qualità audio percepita, ma il costo e l'endpoint sono identici. Puoi scegliere il modello in base alle tue preferenze di qualità senza variazioni di prezzo o di infrastruttura.

Come verifico che la lingua sia corretta?

Imposta il campo 'language' con il codice ISO se il testo non è in inglese o se lo script non è chiaro. Altrimenti, la lingua viene indovinata (il testo latino defaults all'inglese). Supportiamo 23 lingue specifiche. Verifica la lista delle lingue supportate per evitare errori di generazione audio per lingue non coperte.

Posso integrare l'audio nel menu del sito?

Sì, puoi integrare l'audio generato in qualsiasi parte del sito, inclusi i menu. Restituisci l'URL o il file audio e inseriscilo negli elementi HTML del menu. Non ci sono limitazioni tecniche all'integrazione. Assicurati solo che il formato audio sia compatibile con il browser del visitatore e che il file sia accessibile.

È necessario knowledge tecnico per l'uso?

È necessaria una conoscenza tecnica di base per integrare l'API. Devi saper gestire chiamate HTTP o utilizzare SDK. Puoi usare le SDK OpenAI modificando il base_url. Per implementazioni complesse in WordPress, potrebbe essere necessario sviluppo personalizzato. Non offriamo plugin WordPress nativi né assistenza telefonica.

Come si gestiscono le ricariche automatiche?

Le ricariche non sono automatiche. Devi effettuare un pagamento in USDT (TRC-20) sulla rete TRON. Il saldo viene accreditato automaticamente entro minuti dal trasferimento. Non ci sono abbonamenti mensili. Il saldo non scade. Puoi controllare il saldo e la cronologia delle transazioni direttamente dalla pagina del tuo account.

Posso usare la voce per scopi commerciali?

Sì, le voci sono basate su registrazioni con licenza CC BY 4.0 (LibriVox). Puoi utilizzare l'audio generato per scopi commerciali nei tuoi blog o podcast. Ogni file contiene un watermark invisibile che lo identifica come sintesi vocale. Non offriamo clonazione vocale personalizzata.

Quali sono i formati consigliati per il web?

I formati consigliati per il web sono mp3 e opus per la compatibilità e la compressione. wav e flac offrono qualità superiore ma occupano più spazio. pcm è non compresso. Scegli in base al bilanciamento tra qualità e larghezza di banda. Tutti i formati sono supportati dall'endpoint API standard.

Come affronto i tempi di attesa lunghi?

I tempi di attesa variano in base al carico. Per testi lunghi, la velocità è circa reale (25 caratteri al secondo). Le richieste sono elaborate in sequenza. Per evitare attese, genera gli audio in anticipo e memorizzali nella cache. Monitora il carico e pianifica le generazioni durante periodi di minor traffico.

Preparazione dell'ambiente WordPress

Illustrazione dell'onda sonora per: Preparazione dell'ambiente WordPress

Per iniziare l'integrazione, registrati su /get-api-key/ con Google o email. Il piano base non include credito trial se creato con password, mentre l'accesso Google offre $0.50 per 50.000 caratteri validi 7 giorni. Questo credito iniziale permette di validare la connessione prima dell'investimento.

Creazione account API

La registrazione avviene esclusivamente tramite la pagina dedicata del sito. Scegli tra accesso Google o email/password. L'account è legato al singolo dominio 11lab.info e non è condivisibile con altre piattaforme esterne.

Recupero chiave segreta

Dopo l'accesso, il dashboard mostra la chiave API attiva con formato tts-.... È l'unico metodo di autenticazione richiesto tramite header Authorization. Puoi emettere una nuova chiave in qualsiasi momento; la precedente viene revocata istantaneamente.

Configurazione ambiente

Conserva la chiave nelle variabili d'ambiente del tuo server WordPress o nel file wp-config.php. Non esporla nel codice client visibile. L'endpoint base è https://api.11lab.info/v1. Verifica che il server di destinazione possa effettuare chiamate POST HTTPS verso questo dominio.

  • Usa variabili d'ambiente per la chiave
  • Verifica la connettività HTTPS
  • Non hardcodare la chiave nel tema

Scelta della strategia di integrazione

Illustrazione dell'onda sonora per: Scelta della strategia di integrazione

La scelta tra generazione on-demand e batch dipende dal traffico del blog e dalla necessità di coerenza audio. La generazione on-demand crea l'audio al primo accesso dell'utente, ottimizzando lo spazio, mentre il batch pre-calcola i file per tempi di risposta immediati.

Entrambe le strategie richiedono una gestione accurata dei limiti di frequenza e dei costi per carattere. L'approccio batch è ideale per contenuti statici, mentre l'on-demand si adatta meglio a siti con contenuti dinamici o non indicizzati.

Generazione on-demand

Questa strategia invia la richiesta all'endpoint API solo quando l'utente richiede l'audio. È utile per ridurre i costi iniziali, pagando solo per le visualizzazioni effettive. Tuttavia, introduce un leggero ritardo nella pagina al primo caricamento.

Generazione preventiva (batch)

I file audio vengono generati in background durante la pubblicazione dell'articolo. Questo garantisce un'esperienza utente fluida, senza attese durante la navigazione. Richiede però una gestione dello storage per conservare i file generati.

Vantaggi per ogni metodo

La strategia on-demand riduce gli sprechi per articoli poco visitati, mentre il batch assicura prestazioni costanti per il traffico elevato. Entrambi i metodi sfruttano la stessa API e la stessa chiave API, mantenendo i costi trasparenti e prevedibili.

  • On-demand: ideale per siti con contenuti variabili e basso traffico ricorrente.
  • Batch: preferito per articoli evergreen che garantiscono visite costanti nel tempo.

Configurazione tecnica dell'endpoint

Illustrazione dell'onda sonora per: Configurazione tecnica dell'endpoint

L'endpoint principale per la sintesi vocale è POST https://api.11lab.info/v1/audio/speech. Per utilizzare gli SDK ufficiali OpenAI, basta impostare il campo base_url su https://api.11lab.info/v1 e sostituire la chiave API standard con il token tts-... fornito al momento della registrazione.

Impostazione base_url

Configurare correttamente l'URL base è il primo passo per garantire che le richieste HTTP vengano instradate al nostro servizio cloud senza ambiguità. Utilizzando la struttura compatibile con OpenAI, gli sviluppatori possono riutilizzare librerie esistenti senza modificare la logica di chiamata, inserendo semplicemente il nostro dominio nell'oggetto di configurazione.

  • URL: https://api.11lab.info/v1
  • Metodo: POST
  • Formato: JSON

Struttura header richiesta

Ogni richiesta deve includere l'intestazione Authorization con il valore Bearer seguito dalla chiave API unica. Questa credenziale autentica l'account e permette il tracciamento dei costi e dei limiti di frequenza. Assicurarsi che la chiave sia inviata esclusivamente via HTTPS per mantenere la sicurezza delle transazioni.

  • Authorization: Bearer tts-...
  • Content-Type: application/json

Validazione parametri

Prima dell'invio, verificare che il testo non superi i 4096 caratteri e che il formato audio richiesto (mp3, wav, opus, flac, pcm) sia supportato. La velocità deve essere compresa tra 0.25 e 4.0. Le richieste fallite sono gratuite: se la sintesi fallisce, la spesa viene restituita integralmente.

Selezione delle voci appropriate

Illustrazione dell'onda sonora per: Selezione delle voci appropriate

La selezione della voce determina la percezione auditiva del contenuto blog. Disponiamo di otto preset standardizzati, generati da registrazioni licenziate e non da clonazione personalizzata. La scelta deve basarsi sul tono del testo e non su aspettative emotive non presenti nell'API.

Ogni voce offre una timbrica specifica adatta a generi editoriali distinti. È necessario testare brevi frasi per verificare la compatibilità con il pubblico target, poiché la voce non cambia stile in base al contesto ma mantiene una caratteristica fissa per tutta la durata della generazione.

Analisi dei 8 preset

I preset sono divisi per timbrica maschile e femminile. Aria offre una narrazione calda e chiara, ideale per letture lunghe. Nova è luminosa e adatta a contenuti leggeri. Luna ha un tono morbido per storie, mentre Sage è istruzionale e calma.

Felix è energico e adatto a promozioni. Milo è conversazionale e amichevole. Atlas mantiene un tono neutro per notizie. Orion, profondo, è indicato per documentari. Le voci supportano le 23 lingue elencate; se la lingua non è impostata, viene indovinata dal sistema (il testo in latino predefinisce l'inglese).

Ciascuna voce è basata su registrazioni LICENSED e presenta un watermark invisibile. Non ci sono varianti di emozione o tono dinamico. La scelta è binaria: la voce rimane costante per tutta la durata della sintesi del testo inviato.

  • Aria: narratrice calda e chiara
  • Nova: brillante e vivace
  • Luna: morbida, stile storytelling
  • Sage: calma, istruzionale
  • Felix: energica, promozionale
  • Milo: amichevole, conversazionale
  • Atlas: neutra, notizie
  • Orion: profonda, documentaristica

Abbinamento contenuto-voce

L'abbinamento richiede allineamento tra genere editoriale e timbrica vocale. Articoli tecnici beneficiano della neutralità di Atlas o della chiarezza di Sage. I blog personali possono utilizzare Luna per un tono accogliente. Le news richiedono la precisione di Atlas senza distrazioni emotive.

I post promozionali o le recensioni dinamiche si adattano bene a Felix o Nova. È fondamentale considerare che la voce non cambia registro in base alla punteggiatura o al tono del testo scritto. La selezione deve essere fatta in fase di progettazione del template WordPress.

Per contenuti multilingua, assicurarsi che la lingua sia impostata esplicitamente se il testo non è in inglese o nelle lingue native della voce. L'indovinamento automatico può fallire con testi misti o lessico tecnico non comune.

  • News: Atlas (neutrale)
  • Storytelling: Luna (morbida)
  • Promozioni: Felix (energica)
  • Tutorial: Sage (istruzionale)

Prove audio comparative

Eseguire test su frasi representative del vostro blog prima della produzione di massa. Generare 500 caratteri per ogni voce candidata e ascoltare la fluidità. Verificare che la velocità impostata (default 1.0) sia comprensibile per il vostro pubblico target.

Confrontare la stessa frase con voci maschili e femminili. Notare come la pronuncia di termini tecnici o nomi propri possa variare leggermente tra le voci. Utilizzare il formato WAV per le prove per una qualità di ascolto immediata senza compressione.

Registrate le differenze di tono. Se il contenuto è lungo, verificare che la voce scelta non risulti stancante dopo diversi minuti di ascolto. La selezione definitiva deve essere documentata nel configuration file del vostro plugin WordPress.

Gestione dei formati audio

Illustrazione dell'onda sonora per: Gestione dei formati audio

La selezione del formato audio influisce direttamente sulla larghezza di banda e sulla qualità percepita nei player WordPress. MP3 è lo standard di default per la compressione lossy, mentre WAV offre qualità lossless ma occupando fino a sei volte più spazio.

Per ottimizzare i costi di hosting, scegliere il formato giusto tra le opzioni disponibili è fondamentale per garantire una riproduzione fluida senza compromessi eccessivi sulla qualità sonora.

Scelta tra MP3 e WAV

MP3 è consigliato per la maggior parte dei blog grazie al suo equilibrio tra dimensione e qualità. WAV è utile solo se si necessita di editing immediato del file generato senza ulteriore compressione.

  • MP3: ideale per streaming web e risparmio spazio.
  • WAV: qualità originale, file più pesanti.

Compressione Opus/FLAC

Opus offre una compressione efficiente con ottima qualità a bitrates bassi, adatto per connessioni mobili. FLAC mantiene la qualità lossless con una dimensione file inferiore rispetto a WAV, utile per archivi locali.

  • Opus: alta efficienza, ottimo per mobile.
  • FLAC: lossless, ideale per backup.

Compatibilità player web

La maggior parte dei player HTML5 supporta nativamente MP3 e WAV. Per Opus e FLAC, verificare la compatibilità con il browser target o utilizzare codec fallback per garantire l'accessibilità su tutti i dispositivi.

  • MP3/WAV: supporto universale.
  • Opus/FLAC: verifica browser specifici.

Ottimizzazione dei costi

Illustrazione dell'onda sonora per: Ottimizzazione dei costi

Ottimizzare i costi richiede una gestione precisa dei caratteri, poiché la tariffa è fissa a $0,01 per 1.000 caratteri (spazi inclusi). Una stima accurata del testo prima della generazione evita sorprese nel saldo.

Stima caratteri per articolo

Calcola la lunghezza del testo prima di inviare la richiesta. Ogni carattere, incluso lo spazio, conta. Utilizza un conteggio preciso per prevedere il costo esatto della sintesi audio.

  • Spazi e punteggiatura sono conteggiati come caratteri.

Ricarica ottimale USDT

Il minimo di ricarica è $5 in USDT su TRON. Non ci sono piani mensili né costi fissi. Ricarica solo quando necessario per mantenere il flusso di lavoro senza interruzioni.

  • Minimo $5 per transazione.

Monitoraggio sprechi

Monitora le richieste fallite: sono gratuite, ma verificale per assicurarti che non ci siano errori di configurazione. Non ci sono costi nascosti per il storage o le chiamate non riuscite.

Gestione errori e fallback

Illustrazione dell'onda sonora per: Gestione errori e fallback

Il rilevamento degli errori è fondamentale per garantire la continuità del servizio di lettura vocale nei blog. Ogni richiesta fallita non viene addebitata, ma è necessario monitorare le risposte HTTP per identificare i problemi di rete o di formato.

La visibilità dei guasti permette di intervenire rapidamente senza perdere traffico utente o integrità del contenuto audio.

Un logging strutturato facilita il debug tecnico senza richiedere supporto esterno immediato.

Rilevamento failure sintesi

Monitora gli status code REST API per identificare fallimenti immediati o timeout durante la generazione.

Verifica la lunghezza del testo per assicurarti che non superi i 4096 caratteri per richiesta, causa comune di errore.

  • Status 4xx/5xx per errori di sintassi o server
  • Timeout oltre i tempi standard di elaborazione

Log degli errori

Registra timestamp, ID della richiesta e codice errore nel database WordPress per analisi successive.

Mantieni i log per un periodo limitato, coerente con la conservazione dei metadati di fatturazione.

  • Oggetto JSON con errore e timestamp
  • Integrazione con plugin di log esistenti

Strategie di retry

Implementa un backoff esponenziale per le richieste fallite temporanee, limitando i tentativi a tre cicli.

Non retryare errori di parametro (es. voce non valida) per evitare spreco di chiamate.

Considera che le richieste sono elaborate in coda; un picco di traffico può causare latenze temporanee.

  • Max 3 tentativi automatici
  • Backoff esponenziale tra i tentativi
Gestione errori e fallback

Privacy e conformità dati

Illustrazione dell'onda sonora per: Privacy e conformità dati

I nostri servizi garantiscono che il testo inviato venga utilizzato esclusivamente per la generazione dell'audio correlato, senza essere impiegato per l'addestramento dei modelli di intelligenza artificiale. Questo approccio preserva la riservatezza dei contenuti editoriali dei tuoi blog WordPress.

Nessun training sui dati

L'input testuale non entra a far parte del dataset di training. La tua proprietà intellettuale rimane tale, evitando che le tue parole vengano riutilizzate per migliorare altri servizi terzi.

  • Nessun utilizzo per training modelli
  • Proprietà dei contenuti preservata

Cancellazione file generati

I file audio restituiti nella risposta non vengono memorizzati dai nostri server dopo la consegna. Solo i metadati di richiesta (tempo, caratteri, stato) sono conservati per finalità di fatturazione.

Trasparenza utilizzo

L'account dashboard mostra chiaramente caratteri utilizzati e stato del saldo. Ogni generazione è tracciabile per audit, senza dati sensibili aggiuntivi rispetto alla necessità operativa del servizio API.

Aggiornamento e manutenzione

Illustrazione dell'onda sonora per: Aggiornamento e manutenzione

La stabilità del servizio dipende dal rispetto dei limiti di frequenza e dalla corretta gestione delle credenziali. Monitorare i rate limit evita interruzioni nella generazione audio dei contenuti blog.

La scadenza del trial gratuito richiede un'azione tempestiva per mantenere l'accesso. Gli account creati con email e password non includono credito iniziale, richiedendo una ricarica immediata tramite USDT.

Monitoraggio rate limit

Il limite standard è di 60 richieste al minuto per chiave. Prima della prima ricarica, la quota scende a 10 richieste/min. Superato il limite, le richieste vengono accodate o rifiutate.

  • Controllare l'header X-RateLimit-Remaining nelle risposte API
  • Implementare un backoff esponenziale in caso di 429 Too Many Requests
  • Ridurre la frequenza di generazione batch per articoli lunghi

Aggiornamento SDK

Utilizzando l'SDK ufficiale OpenAI con base_url modificata, gli aggiornamenti della libreria client devono essere gestiti manualmente nel composer.json di WordPress. Non esiste un SDK proprietario nativo per WordPress.

  • Verificare la compatibilità delle versioni di PHP e delle dipendenze HTTP
  • Testare l'endpoint /v1/voices dopo ogni aggiornamento maggiore per confermare la disponibilità delle voci

Gestione scadenza trial

Il credito gratuito di $0,50 scade dopo 7 giorni dalla registrazione. È necessario effettuare una ricarica minima di $5 in USDT (TRC-20) per mantenere l'accesso senza interruzioni.

  • Impostare un reminder per il 6° giorno di vita dell'account
  • Verificare che il saldo sia positivo prima di lanciare campagne di generazione automatica

Confronto con alternative mercato

Illustrazione dell'onda sonora per: Confronto con alternative mercato

A differenza dei provider che offrono piani mensili o abbonamenti, la nostra infrastruttura applica un costo fisso di $10 per milione di caratteri, senza costi fissi né impegni di spesa minima. Questo modello elimina le inefficienze di pagamento per funzionalità non utilizzate, garantendo che il costo sia direttamente proporzionale al volume di testo generato.

L'assenza di piani base o tiered permette ai freelancer di scalare l'uso senza sorprese nella fatturazione, pagando esclusivamente per i caratteri effettivamente elaborati.

Differenze con altri provider

Molti competitor richiedono abbonamenti mensili per accedere alle voci di alta qualità o per rimuovere i limiti di utilizzo. Il nostro modello è puramente a consumo: non ci sono piani base, né costi di licenza ricorrenti. La chiave API è l'unico requisito per l'accesso immediato alle 8 voci disponibili.

Vantaggi prezzo fisso

Il prezzo di $0.01 per 1.000 caratteri rimane costante indipendentemente dal volume. Non esistono surcharge per le chiamate HD o per i formati specifici come WAV o FLAC. La trasparenza dei costi facilita il calcolo preciso dei margini per ogni articolo blog o post WordPress.

Limiti tecnici noti

A differenza di alcune piattaforme enterprise, non offriamo streaming WebSocket in tempo reale né supporto SSML per il controllo fine della pronuncia. Non è possibile clonare voci personalizzate o inserire tag di emozione. La generazione avviene in file completi, il che può introdurre una latenza iniziale per testi molto lunghi.

  • Nessun supporto SSML
  • Nessuna clonazione voce custom
  • Nessuno streaming in tempo reale

Esempio di codice completo

Illustrazione dell'onda sonora per: Esempio di codice completo

L'integrazione richiede un semplice script PHP che invia la richiesta all'endpoint API e gestisce il file audio restituito. Questo approccio garantisce che ogni articolo del blog venga convertito in audio senza dipendenze esterne complesse.

Il codice deve gestire la chiave API, il testo da sintetizzare e i parametri di formato. La risposta contiene il file audio binario (o un riferimento ad esso), non un link diretto.

Script PHP per WordPress

Utilizza cURL per inviare una POST request all'endpoint https://api.11lab.info/v1/audio/speech. Include l'header Authorization con la chiave Bearer e il body JSON con model, voice e input.

Il codice deve verificare che il testo non superi i 4096 caratteri per richiesta, come richiesto dall'API.

  • Inviare la richiesta POST con il testo del post.
  • Leggere la risposta JSON contenente l'URL del file audio.
  • Validare lo status code 200 prima di procedere.

Gestione risposta JSON

La risposta contiene un URL pubblico per il file audio generato. Il file audio viene restituito nella risposta e non viene memorizzato dai nostri server.

Il codice deve parsare la risposta per estrarre l'URL del file, gestendo eventuali errori HTTP o code di elaborazione.

  • Estrarre l'URL dal campo 'url' della risposta.
  • Gestire i codici di errore specifici dell'API.
  • Loggare l'ID della richiesta per debug.

Salvataggio file locale

Per ottimizzare le prestazioni, il file audio può essere scaricato e salvato nella cartella uploads di WordPress. Questo riduce la dipendenza dall'hosting esterno per le riproduzioni successive.

Il nome del file può essere basato sull'ID del post o su un hash del testo, evitando conflitti di nome.

  • Elaborare il file audio restituito nella risposta.
  • Salvarlo nella directory wp-content/uploads/.
  • Aggiornare il post con il link locale per l'player audio.

Checklist finale pre-lancio

Illustrazione dell'onda sonora per: Checklist finale pre-lancio

Prima di pubblicare il plugin, verifica che il saldo del tuo account API sia sufficiente per coprire i primi cicli di generazione. La ricarica in USDT richiede pochi minuti per essere accreditata; assicurati che i fondi siano disponibili prima di attivare la produzione in produzione.

Conferma che i file audio generati siano leggibili sui dispositivi mobili standard. Poiché non offriamo SDK nativi, testa la compatibilità dei tag <audio> HTML5 con i principali browser mobile per garantire un'esperienza utente fluida senza errori di riproduzione.

Verifica saldo attivo

Accedi alla dashboard /get-api-key/ e controlla il valore del saldo attuale. Il costo è di $0.01 per 1.000 caratteri; calcola il volume mensile previsto per evitare blocchi del servizio durante la pubblicazione dei post.

Assicurati che la chiave API sia attiva e associata all'account corretto. Una nuova chiave invalida la precedente istantaneamente; verifica di non aver perso l'accesso durante le configurazioni di test.

  • Controllare il saldo nella dashboard
  • Verificare la chiave API attiva
  • Confermare la ricarica USDT completata

Test formato audio

Genera un file di prova in MP3 e WAV per verificare che la lunghezza sia coerente con i tempi di lettura previsti. Ricorda che la velocità è impostabile tra 0.25 e 4.0; testa la voce scelta con il testo effettivo dell'articolo.

Valida che il player web supporti il formato scelto. L'opus e il FLAC offrono compressione efficiente ma richiedono verifiche di compatibilità specifiche con i browser dei lettori.

  • Testare MP3 e WAV
  • Verificare lunghezze audio
  • Validare il player web

Conferma supporto mobile

Apri l'URL del post generato su dispositivi iOS e Android. Verifica che il pulsante di riproduzione sia visibile e funzionante senza overlay invasivi.

Assicurati che la larghezza di banda non limiti il caricamento dei file audio su reti 4G/5G mobili, mantenendo i formati ottimizzati come consigliato.

  • Test su iOS e Android
  • Verifica visibilità player
  • Controllo larghezza banda

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. FFmpeg documentation
  3. Node.js documentation
  4. curl documentation
  5. openai-node on GitHub
  6. Creative Commons Attribution 4.0
  7. openai-python on GitHub
  8. W3C WAI: making audio and video accessible
  9. ISO 639 language codes
  10. MDN: Web Speech API
  11. OpenAI API reference: create speech
  12. Python documentation

Altro su questo sito