Cosa mi consente di costruire l'API di Podhoc?

Tutto ciò che trasforma testo sul web in audio multi-voce in stile podcast: pipeline newsletter-a-podcast, onboarding audio per prodotti SaaS, guide di studio automatiche per piattaforme di apprendimento, briefing executive per team di ricerca, livelli di accessibilità per portali di contenuto, walkthrough di prodotto multilingue. L'API è volutamente minima — POST di un URL, interroga, scarica — quindi i pattern di integrazione sono perlopiù questione di idraulica dal tuo lato.

Mi serve un piano Pro per usare l'API?

Sì. L'accesso API è incluso nel piano Pro (29 €/mese, 3500 crediti) e superiori. I piani Free e Creator non includono token API. I token si creano su app.podhoc.com/account/api-access una volta aggiornato l'abbonamento.

Quanto costa ogni podcast in crediti?

Il costo base è `max(30, ceil(duration_minutes × 2,5))`. Un episodio di 10 minuti costa 30 crediti base. Il bonus multi-source aggiunge 20, il bonus pesi personalizzati 10, multi-voice moltiplica per 1,2, con tetto a 500 crediti. L'API applica un moltiplicatore aggiuntivo di 1,5x (test) o 2,5x (produzione). Usa GET /v1/estimate-cost per visualizzare in anteprima prima di generare.

Quale pattern di integrazione è il più economico per iniziare?

Una pipeline di digest giornaliero. Scegli una sorgente di input (URL di una newsletter, feed RSS, lista curata), genera un episodio breve (10-15 minuti) al giorno in una lingua, salvalo nel tuo bucket. Sono circa 30-50 crediti al giorno, ben dentro il piano Pro. Il pattern è breve, osservabile e ti dà una visione completa end-to-end di costi, latenza e qualità di output.

Posso generare podcast in più lingue dalla stessa sorgente?

Sì. La lingua sorgente e quella di output sono disaccoppiate — Podhoc supporta 74 lingue di input e 74 di output con voci native in ognuna. Un pattern comune è chiamare POST /v1/podcasts una volta per lingua target, con lo stesso URL ma un parametro `language` diverso. Pagherai il costo in crediti per ogni chiamata. Non tradurre la sorgente dal tuo lato — lascia che lo faccia Podhoc durante la generazione.

Come evito di creare podcast duplicati quando la mia pipeline ritenta?

Tieni traccia del `podcast_id` restituito dall'endpoint di creazione. Persistilo insieme all'URL sorgente e ai parametri nel tuo datastore prima di interrogare. Se la pipeline si schianta a metà interrogazione, puoi riprendere sullo stesso `podcast_id` invece di ricreare (e riaddebitare). Le chiavi di idempotenza non sono ancora una funzione di prima classe dell'API, quindi la disciplina vive nel tuo client.

Posso scatenare la generazione da una piattaforma di chat?

Sì. Il bot Telegram di Podhoc lo fa già — vedi [Come usare il bot Telegram di Podhoc](/blog/telegram-bot-howto/). Per la tua integrazione, cattura l'input della chat (Slack, Discord, Microsoft Teams), estrai gli URL con una regex, chiama POST /v1/podcasts e rispondi con un link di stato o — una volta completato — un link di download. Costruisci un pattern chat-a-podcast in un pomeriggio.

Quali sono i limiti di frequenza dell'API?

Token di test: 2 richieste/minuto, 20/ora, 1 generazione concorrente. Token di produzione: 30 richieste/minuto, 300/ora, 5 generazioni concorrenti. Quando raggiungi un limite, la risposta è HTTP 429 con header Retry-After. Costruisci la tua coda intorno al limite concorrente (5 job alla volta in produzione) e al throttle al minuto.

Idee di integrazione con l'API di Podhoc: 12 pattern per la generazione programmatica di podcast

2026-05-06 · Aggiornato 2026-05-07

Pattern pratici di integrazione con l'API di Podhoc: pipeline newsletter-a-podcast, piattaforme di apprendimento, strumenti di conoscenza interna, briefing di ricerca, onboarding multilingue e altro. Schemi di architettura, budget di crediti, profili di latenza.

Dodici modi in cui i team mettono al lavoro l’API di Podhoc

Una volta che hai un token API di Podhoc, la domanda non è più se puoi generare podcast in modo programmatico — ma cosa dovresti generare, per chi e come si inserisce nel resto del tuo prodotto. Questo articolo cataloga i dodici pattern di integrazione che vediamo più spesso nel primo mese di adozione dell’API, con note di architettura, budget di crediti e i dettagli che si imparano solo dopo aver spedito.

Se non hai ancora fatto la tua prima chiamata API, inizia da Come generare podcast con l’API di Podhoc. Una volta che conosci il ciclo crea-interroga-scarica, i pattern qui sotto sono perlopiù variazioni della stessa idraulica.

Nota di traduzione: da rivedere da un madrelingua italiano.

L’integrazione più semplice è un digest giornaliero o settimanale automatizzato del contenuto della tua newsletter.

Come funziona. Un cron parte una volta al giorno. Recupera l’URL dell’ultima newsletter (RSS, Substack, il tuo CMS), chiama POST /v1/podcasts con target_duration_minutes: 15 e style: "deep_dive", interroga fino al completamento, copia l’MP3 nel tuo bucket e invia una notifica ai tuoi abbonati.

Crediti. ~75 crediti per episodio di 15 minuti (moltiplicatore Pro). 7 giorni × 75 = 525 crediti/settimana, ben dentro i 3500 crediti del piano Pro.

Perché è una buona prima integrazione. Una sola sorgente per chiamata, una sola lingua, niente pubblicazione automatica, modi di fallimento prevedibili. Ottieni una pipeline end-to-end funzionante in un giorno e puoi osservare costi, latenza e drift di qualità su una settimana prima di impegnarti in qualcosa di più grande.

Attenzione a. URL di newsletter dietro un muro di login sono irraggiungibili — Podhoc recupera la versione pubblica. Se la tua newsletter richiede autenticazione, fanne prima un mirror su un URL canonico pubblico (o contattaci per un’integrazione enterprise).

2. Onboarding audio SaaS

Sostituisci 30 minuti di “guarda questo video” con 30 minuti di “ascolta questo episodio” che gli utenti possono riprodurre in palestra, durante il tragitto o mentre cucinano.

Come funziona. Quando un utente si registra, il tuo backend chiama POST /v1/podcasts con l’URL della tua pagina di partenza, target_duration_minutes: 20, style: "didactic". L’MP3 atterra nel tuo CDN. La prossima volta che l’utente apre l’app, gli proponi la versione audio dell’onboarding.

Perché cambia le metriche di adozione. La maggior parte degli onboarding SaaS fallisce perché gli utenti sono troppo occupati per sedersi e guardare. L’audio recupera tempo di tragitto. Le aziende che applicano questo pattern segnalano miglioramenti significativi nell’adozione delle funzionalità nella prima settimana — senza cambiare nulla del prodotto sottostante.

Attenzione a. Genera una versione master per flusso di onboarding invece di una per registrazione. Gli utenti che vedono tutti lo stesso contenuto di partenza possono ascoltare lo stesso MP3. Il caching a livello di URL sorgente riduce la spesa in crediti di 100x.

3. Guide di studio auto-generate su piattaforme di apprendimento

A ogni pubblicazione di un modulo del corso, genera automaticamente un compagno audio di 15 minuti nella lingua preferita dello studente.

Come funziona. L’evento di pubblicazione del modulo si scatena. Il tuo backend chiama POST /v1/podcasts con l’URL pubblico del modulo (o un mirror pubblico), target_duration_minutes: 15, style: "feynman_technique" per contenuto esplicativo o style: "didactic" per materiale procedurale. Fan-out per lingua: una chiamata per lingua supportata con lo stesso URL e un codice language diverso.

Crediti. ~75 crediti × 4 lingue × N moduli. Estendi il fan-out di lingue gradualmente — inizia con una, aggiungine altre man mano che l’adozione giustifica la spesa.

Perché gli studenti si ingaggiano. Il formato Feynman Technique scompone i concetti in ragionamento da primi principi, la stessa strategia di apprendimento attivo che spinge la ritenzione a lungo termine. Vedi perché funziona l’apprendimento audio per il contesto della scienza cognitiva.

Attenzione a. Contenuto del corso con tabelle, equazioni o immagini ricche si degrada quando ridotto a testo. Prova prima sul tuo modulo più difficile — se feynman_technique produce un episodio che gestisce le equazioni come prosa, puoi scalare.

4. Conoscenza interna — trasforma la wiki in compagna di tragitto

La maggior parte della documentazione interna viene letta una volta e dimenticata. Una versione audio la trasforma in qualcosa che puoi rinfrescare sulla strada per il lavoro.

Come funziona. Un cron itera su una lista curata di URL di doc interni (pagine Confluence pubblicate, doc Notion, sito GitHub Pages). Per ogni URL, genera un episodio di 10 minuti nella lingua di lavoro dell’azienda. Spingi l’MP3 in un feed podcast privato (RSS) a cui solo dipendenti autenticati possono iscriversi.

Crediti. ~30-45 crediti per episodio di 10 minuti. Un batch settimanale di 20 doc è 600-900 crediti a settimana.

Attenzione a. I doc interni devono essere raggiungibili come URL pubblici. Il pattern standard è specchiarli su un URL pubblico ma non indovinabile (CloudFront con protezione signed cookie, o uno slug univoco) e passarlo a Podhoc.

5. Briefing settimanale per team di ricerca

Sintesi multi-source — combina 5-10 paper in un singolo briefing di 30 minuti.

Come funziona. Una volta a settimana, il tuo feed di ricerca segnala i 5-10 nuovi paper più rilevanti nel dominio del team. Il tuo backend chiama POST /v1/podcasts con tutti gli URL in una volta, target_duration_minutes: 30, style: "critique" per incoraggiare valutazione metodologica invece di riassunto acritico.

Crediti. Il bonus multi-source è +20 crediti, il moltiplicatore di voci è 1,2x, quindi un episodio di 30 minuti con 10 sorgenti viene circa 200 crediti su un token di produzione. Uno a settimana sta comodamente dentro Pro.

Perché critique? I paper di ricerca beneficiano di un formato che sonda la metodologia invece di ripetere i risultati. Prova gli 8 stili audio sugli ultimi 5 paper del team prima di impegnarti.

Attenzione a. Un conteggio voci di 2 (o 3 su token Pro) è più ingaggiante di 1 per briefing lunghi. Multi-voice scatena il moltiplicatore 1,2x; metti in budget di conseguenza.

6. Livello di accessibilità — ogni articolo pubblicato disponibile come audio

Esegui generazione audio automatica su ogni pagina del tuo sito di contenuto, costruisci un link audio su ogni articolo, fornisci un feed podcast accanto.

Come funziona. Quando il CMS pubblica un nuovo articolo, scatena un webhook che chiama POST /v1/podcasts con l’URL dell’articolo, una durata breve (target_duration_minutes: 8 per articoli brevi), style: "simplified_explanation" per una rinarrazione accessibile. Metti in cache l’MP3 in S3, esponilo come /article/audio/<slug>.mp3. Aggiungi un AudioObject JSON-LD all’articolo così i motori di ricerca facciano emergere la versione audio.

Perché conta per la SEO. Google sta indicizzando attivamente il contenuto podcast accanto agli articoli. Far emergere una versione audio su ogni post lungo aumenta la superficie di ricerca senza scrivere un secondo pezzo di contenuto. Il vantaggio di accessibilità è altrettanto reale — lettori con dislessia, ipovisione o difficoltà di attenzione ottengono un’esperienza di prima classe.

7. Walkthrough di prodotto multilingue

Genera lo stesso contenuto come podcast nelle 5 lingue clienti principali per avere onboarding di qualità nativa senza budget di localizzazione.

Come funziona. Prendi l’URL canonico inglese del tuo walkthrough. Fai fan-out una chiamata POST /v1/podcasts per lingua target. Conserva gli MP3 in path etichettati per lingua nel tuo CDN (/audio/onboarding-en.mp3, /audio/onboarding-it.mp3, etc.). Mostra quello giusto in base al locale dell’utente.

Crediti. 5 lingue × ~75 crediti = 375 crediti per walkthrough. Assicurazione economica rispetto al commissionare doppiaggi tradotti.

Perché batte le traduzioni umane registrate. Il TTS multilingue di Podhoc produce voci di qualità nativa in 74 lingue. L’output non è una traduzione robotica — è una rinarrazione nella lingua target con ritmo ed enfasi appropriati. Confronta fianco a fianco con un modello tts="natural" e sentirai la differenza.

Attenzione a. Alcuni contenuti tecnici hanno modi di dire inglesi (“ship it”, “raise the alarm”) che traducono male. Genera la prima versione in 2-3 lingue target e verifica con madrelingua prima di scalare a 5.

8. Audio di follow-up customer success

Dopo ogni chiamata di onboarding, il tuo team CSM scrive un’email di follow-up con punti d’azione e risorse. Convertila in un riassunto audio personalizzato.

Come funziona. Il CSM pubblica il documento di follow-up su un URL CDN pubblico-ma-privato. Il backend chiama POST /v1/podcasts con target_duration_minutes: 5, style: "didactic". Il cliente riceve un riepilogo audio di 5 minuti che può riprodurre sulla strada per la prossima riunione.

Crediti. ~38-45 crediti per episodio di 5 minuti. 100 clienti × 4 chiamate/anno = 400 episodi × 45 crediti = 18.000 crediti/anno. Significativo ma limitato — sta comodamente in un pattern enterprise Pro-plus.

Perché si guadagna il posto. Pochi CSM si fidano che i loro clienti leggano l’email di follow-up per intero. Una versione audio atterra dove l’email non atterra.

9. Briefing competitivi per sales-enablement

Genera un briefing audio settimanale sugli aggiornamenti blog di ogni competitor così il team commerciale resta aggiornato senza leggere 12 newsletter.

Come funziona. Mantieni una lista curata di URL competitor (i loro changelog, blog, roadmap pubbliche). Una volta a settimana, il tuo script raccoglie i 3 più freschi di ognuno, chiama POST /v1/podcasts con tutti gli URL e style: "critique", genera un briefing di 25-30 minuti.

Crediti. ~150-200 crediti per briefing settimanale. Banale rispetto al costo del tempo di un commerciale a leggere.

Attenzione a. Gli URL dei competitor cambiano. Costruisci un piccolo monitor che avvisa quando un URL fa 404.

10. Generazione guidata da chat (Slack / Discord / Teams)

Lascia che qualsiasi membro del team digiti un URL in un canale di chat e riceva un podcast nella sua DM.

Come funziona. Il tuo bot ascolta i messaggi con URL. Estrai l’URL, cerca lingua e durata preferite dell’utente nel tuo store di impostazioni, chiama POST /v1/podcasts, interroga, rispondi con un link di download.

Perché abbassa la frizione di adozione. La maggior parte degli strumenti interni fallisce perché nessuno ricorda l’URL. Un punto d’ingresso da chat vive dove le persone già lavorano. Il bot Telegram è un esempio elaborato di questo pattern, completamente desplegato e open-source.

11. Show programmato — feed podcast giornaliero da un tema

Costruisci un vero feed podcast che pubblica un nuovo episodio di 15 minuti ogni giorno feriale basato su una lista curata di sorgenti.

Come funziona. Cron alle 06:00 seleziona i 3 URL principali del giorno dal tuo feed sorgente, chiama POST /v1/podcasts con target_duration_minutes: 15, scarica l’MP3, costruisce un item RSS, pubblica il feed. Gli ascoltatori si iscrivono in Apple Podcasts, Spotify, Overcast — non sanno nemmeno che è IA.

Crediti. ~80 crediti/giorno × 5 giorni = 400 crediti/settimana.

Attenzione a. Un vero feed RSS ha bisogno di cover art, metadata di episodio e un nome host stabile. Usa un servizio di hosting podcast (Transistor, Buzzsprout) per saltare il dolore della validazione iTunes.

12. Alternativa NotebookLM per audio di documenti in batch

Se il tuo team usa overview audio in stile NotebookLM ad hoc, passa all’API per produzione ripetibile e scriptabile.

Come funziona. Costruisci uno strumento interno sottile: butta una lista di URL in un form, scegli stile e durata, ricevi una notifica Slack quando ogni episodio è pronto. Sostenuto dall’API, il tuo team ottiene il workflow alternativa a NotebookLM senza i limiti di frequenza e senza la frizione del “clicca 14 volte per generare un episodio”.

Perché i team passano dagli strumenti interattivi all’API. I prodotti in stile NotebookLM sono calibrati per un episodio alla volta. Una volta che ne vuoi 50, l’API è l’unica strada sensata.

Scegliere il primo pattern

Pattern	Tempo di setup	Budget settimanale crediti	Migliore per
Newsletter a podcast	1 giorno	~500	Prima integrazione
Onboarding audio SaaS	1 settimana	Una volta	Flusso onboarding esistente
Compagni di apprendimento	2 settimane	Variabile	Prodotti ricchi di corsi
Feed conoscenza interna	1 settimana	~600	Team ingegneria / doc
Briefing settimanale ricerca	1 settimana	~200	Team ricerca
Livello di accessibilità	2 settimane	Per pubblicazione	Siti di contenuto
Walkthrough multilingue	1 settimana	Una volta	Prodotti internazionali
Audio di follow-up CSM	2 settimane	~400	SaaS high-touch
Briefing competitivi	1 settimana	~150	Team sales-enablement
Generazione da chat	1 settimana	Per scatenamento	Botteghe di strumenti interni
Feed podcast giornaliero	2 settimane	~400	Strategie di audience
Alternativa a NotebookLM	1 settimana	Per scatenamento	Workflow ricchi di documenti

Scegli prima il pattern più economico e piccolo. Osserva costo, latenza e qualità di output per due settimane prima di scalare.

Note architetturali che si applicano a ogni pattern

Alcune cose che ogni integrazione di successo fa nello stesso modo:

Persistere podcast_id prima di interrogare. Le cadute sono inevitabili; riprendere risparmia crediti.
Stimare il costo prima di addebitare. GET /v1/estimate-cost è gratuito — chiamalo come guard rail nel tuo client.
Cache per URL sorgente + parametri. Molti pattern generano due volte la stessa cosa. Memoizza.
Timeout dell’interrogazione a 15 minuti. La generazione di solito termina in 2-5; un tetto di 15 minuti fa emergere fallimenti reali senza appendere il tuo worker.
Logga meta.request_id su ogni errore. Il supporto correla con esso.
Tratta il token di test come tuo livello CI. Esegui i test di integrazione lì. I token di produzione sono solo per traffico di produzione.

La disciplina è la stessa di qualsiasi altra integrazione API REST — le filosofie di design di Stripe e dell’API di Anthropic convergono sullo stesso pugno di pattern. Nessuno è specifico di Podhoc.

Cosa leggere dopo

Come generare podcast con l’API di Podhoc — il walkthrough crea-interroga-scarica.
Guida agli stili audio — scegli feynman_technique vs critique vs deep_dive deliberatamente.
Alternativa a NotebookLM — confronto se stai migrando da NotebookLM.
Riferimento API — la documentazione completa di endpoint ed errori.

L’API esce con una superficie piccola e un singolo contratto. I pattern si moltiplicano in fretta. Scegline uno, spedisci in una settimana, poi raddoppia su quello che i tuoi utenti hanno davvero ingaggiato.

Ottieni un token API →

Domande frequenti

Cosa mi consente di costruire l'API di Podhoc?: Tutto ciò che trasforma testo sul web in audio multi-voce in stile podcast: pipeline newsletter-a-podcast, onboarding audio per prodotti SaaS, guide di studio automatiche per piattaforme di apprendimento, briefing executive per team di ricerca, livelli di accessibilità per portali di contenuto, walkthrough di prodotto multilingue. L’API è volutamente minima — POST di un URL, interroga, scarica — quindi i pattern di integrazione sono perlopiù questione di idraulica dal tuo lato.
Mi serve un piano Pro per usare l'API?: Sì. L’accesso API è incluso nel piano Pro (29 €/mese, 3500 crediti) e superiori. I piani Free e Creator non includono token API. I token si creano su app.podhoc.com/account/api-access una volta aggiornato l’abbonamento.
Quanto costa ogni podcast in crediti?: Il costo base è max(30, ceil(duration_minutes × 2,5)). Un episodio di 10 minuti costa 30 crediti base. Il bonus multi-source aggiunge 20, il bonus pesi personalizzati 10, multi-voice moltiplica per 1,2, con tetto a 500 crediti. L’API applica un moltiplicatore aggiuntivo di 1,5x (test) o 2,5x (produzione). Usa GET /v1/estimate-cost per visualizzare in anteprima prima di generare.
Quale pattern di integrazione è il più economico per iniziare?: Una pipeline di digest giornaliero. Scegli una sorgente di input (URL di una newsletter, feed RSS, lista curata), genera un episodio breve (10-15 minuti) al giorno in una lingua, salvalo nel tuo bucket. Sono circa 30-50 crediti al giorno, ben dentro il piano Pro. Il pattern è breve, osservabile e ti dà una visione completa end-to-end di costi, latenza e qualità di output.
Posso generare podcast in più lingue dalla stessa sorgente?: Sì. La lingua sorgente e quella di output sono disaccoppiate — Podhoc supporta 74 lingue di input e 74 di output con voci native in ognuna. Un pattern comune è chiamare POST /v1/podcasts una volta per lingua target, con lo stesso URL ma un parametro language diverso. Pagherai il costo in crediti per ogni chiamata. Non tradurre la sorgente dal tuo lato — lascia che lo faccia Podhoc durante la generazione.
Come evito di creare podcast duplicati quando la mia pipeline ritenta?: Tieni traccia del podcast_id restituito dall’endpoint di creazione. Persistilo insieme all’URL sorgente e ai parametri nel tuo datastore prima di interrogare. Se la pipeline si schianta a metà interrogazione, puoi riprendere sullo stesso podcast_id invece di ricreare (e riaddebitare). Le chiavi di idempotenza non sono ancora una funzione di prima classe dell’API, quindi la disciplina vive nel tuo client.
Posso scatenare la generazione da una piattaforma di chat?: Sì. Il bot Telegram di Podhoc lo fa già — vedi Come usare il bot Telegram di Podhoc. Per la tua integrazione, cattura l’input della chat (Slack, Discord, Microsoft Teams), estrai gli URL con una regex, chiama POST /v1/podcasts e rispondi con un link di stato o — una volta completato — un link di download. Costruisci un pattern chat-a-podcast in un pomeriggio.
Quali sono i limiti di frequenza dell'API?: Token di test: 2 richieste/minuto, 20/ora, 1 generazione concorrente. Token di produzione: 30 richieste/minuto, 300/ora, 5 generazioni concorrenti. Quando raggiungi un limite, la risposta è HTTP 429 con header Retry-After. Costruisci la tua coda intorno al limite concorrente (5 job alla volta in produzione) e al throttle al minuto.