Com generar pòdcasts amb l'API de Podhoc: guia completa
Genera pòdcasts amb IA de manera programàtica amb l'API REST de Podhoc. Autenticació, cicle crear-consultar-descarregar, límits de freqüència.
Cal Pro actiu o en prova per crear o renovar tokens de prova o producció. Els tokens de prova gasten crèdits reals; no és un entorn gratuït. Desa les claus al servidor, fora del navegador, URL, registres i repositoris.
Les fonts han de ser URL públiques compatibles. L’API no accepta fitxers pujats ni text enganxat. No publiquis documents confidencials per utilitzar-la.
Primera petició segura
L’exemple utilitza una font pública fictícia. Genera àudio i gasta crèdits: consulta saldo i estimació i aprova un pressupost. Cinc minuts amb una veu costen 72 crèdits amb el multiplicador de prova predeterminat; segueix l’estimació si la configuració canvia.
Desa un Idempotency-Key nou per cada generació volguda abans d’enviar. Davant d’una resposta incerta, repeteix la mateixa clau i contingut. Es retorna el rebut original; contingut diferent amb la mateixa clau dona 409. Un timeout no justifica una clau nova.
Límits i preus
Prova: 2 peticions/minut, 20/hora, 1 generació simultània, màxim 5 minuts, 1 URL i anglès. Producció: 30/minut, 300/hora i 5 simultànies, segons límits Pro. Respecta Retry-After amb 429.
Base: max(36, ceil(minuts × 10 / 3)). Diverses fonts afegeixen 27 crèdits; pesos, 13; diverses veus estàndard multipliquen el subtotal per 1,2 amb arrodoniment i límit aplicable. Després, multiplicador API: 2× prova i 3,5× producció per defecte. Pot variar. Trenta minuts amb una font i veu: 100 × 3,5 = 350 crèdits en producció. Prova no admet 30 minuts.
Fes estimate-cost amb els mateixos ajustos i revisa final_credits i credit_multiplier. Comprova el saldo restant abans d’aprovar. La durada és aproximada; es cobra la configuració, no el cronòmetre de l’àudio final.
Estat, descàrrega i errors
Amb prova, consulta cada 240 segons o menys sovint, fins a 12 vegades, reservant capacitat per a altres peticions. En producció limita les consultes i respecta les capçaleres. Si segueix pendent, desa l’ID i torna més tard; no dupliquis la creació. No es promet un webhook de finalització.
Descarrega només amb completed. Un error ha de mostrar el motiu final; revisa saldo i reemborsament abans de reintentar. La URL és temporal i privada: no la publiquis ni la desis com a adreça permanent.
Privacitat, publicació i eliminació
El resultat és públic per defecte. Creator i Pro permeten triar privat abans de generar; els episodis privats es poden publicar després confirmant els drets. L’API de producció respecta l’elecció del propietari subscrit; els tokens de prova no poden publicar. Per crear en privat, envia explícitament auto_publish=false amb el teu compte Pro.