Come generare podcast con l'API di Podhoc: guida completa
Genera podcast con IA in modo programmatico tramite l'API REST di Podhoc. Autenticazione, ciclo crea-interroga-scarica, limiti di frequenza.
Serve Pro attivo o in prova per creare o ruotare token di test e produzione. I test consumano crediti reali: non è una sandbox gratuita. Conserva le chiavi sul server, fuori da browser, URL, log e repository.
Le fonti devono essere URL pubblici supportati. L’API non accetta file caricati o testo incollato. Non pubblicare documenti riservati per usarla.
Prima richiesta sicura
L’esempio usa una fonte pubblica fittizia e consuma crediti. Leggi saldo e stima, poi approva un budget. Cinque minuti con una voce costano 72 crediti al moltiplicatore test predefinito; usa la stima restituita se la configurazione cambia.
Salva un nuovo Idempotency-Key per ogni creazione voluta prima dell’invio. Per risposte incerte ripeti stessa chiave e contenuto: torna la ricevuta originale. Contenuto diverso dà 409. Un timeout non giustifica una nuova chiave.
Limiti e prezzi
Test: 2 richieste/minuto, 20/ora, 1 generazione simultanea, massimo 5 minuti, 1 URL e inglese. Produzione: 30/minuto, 300/ora e 5 simultanee entro i limiti Pro. Rispetta Retry-After su 429.
Base: max(36, ceil(minuti × 10 / 3)). Più fonti: +27 crediti; pesi: +13; più voci standard: ×1,2 con arrotondamento e limite. Poi moltiplicatore API: 2× test e 3,5× produzione predefiniti, configurabili. Produzione 30 minuti/una fonte/una voce: 100 × 3,5 = 350 crediti. Il test non consente 30 minuti.
Usa estimate-cost con le stesse impostazioni; controlla final_credits, credit_multiplier e saldo residuo. La durata è indicativa; il prezzo riguarda le impostazioni richieste, non il cronometro finale.
Stato, download ed errori
In test interroga non più spesso di ogni 240 secondi, massimo 12 volte, riservando capacità per altre richieste. In produzione usa attesa limitata e rispetta gli header. Se ancora in attesa, salva l’ID e riprendi dopo; non duplicare. Non viene promesso un webhook di completamento.
Scarica solo dopo completed. Controlla motivo d’errore, saldo e rimborso prima di riprovare. L’URL è temporaneo e privato; non pubblicarlo come indirizzo permanente.
Privacy, pubblicazione ed eliminazione
Il risultato è pubblico per impostazione predefinita. Creator e Pro consentono la creazione privata; un episodio privato può essere pubblicato in seguito confermando i diritti. L’API di produzione rispetta la scelta dell’abbonato; i token di test non possono pubblicare. Per creare in privato, invia esplicitamente auto_publish=false con il tuo account Pro.