Documentazione API Podhoc

Integra la generazione di podcast nelle tue applicazioni

Podhoc offre un’API REST con Pro per generare audio da URL. Google Cloud documenta un’API in Preview per gli Audio Overviews dei notebook e un’API autonoma per i podcast. Configurazione, autenticazione e limiti differiscono; consulta la documentazione aggiornata prima di integrare.

API audio di Google Cloud. Confronto verificato il 16 settembre 2026.

Pubblicazione predefinita: con i token di produzione, omettere auto_publish equivale a true: il podcast generato può essere pubblico in Discover. Invia esplicitamente "auto_publish": false per richiedere audio privato; l’account deve consentire il controllo della pubblicazione. I token di test usano false per impostazione predefinita e non possono pubblicare automaticamente. Una fonte privata non rende privato l’audio generato.

Modifica incompatibile – ora style viene validato. Uno style fornito esplicitamente che non sia uno dei nove identificatori canonici ora restituisce 400 INVALID_STYLE. Fino a questa modifica un valore non riconosciuto veniva accettato in silenzio e generato come deep_dive. Le versioni precedenti di questa pagina usavano "style": "conversational" negli esempi: conversational non e mai stato un identificatore reale, quindi quelle chiamate producevano deep_dive da sempre e l’audio ricevuto non era quello che la documentazione lasciava intendere. Sostituisci qualsiasi valore non riconosciuto con un identificatore canonico. Omettere style, o inviare null o una stringa vuota, continua a usare deep_dive come predefinito.

Fonti di contenuto: L’API accetta solo URL accessibili pubblicamente. Il caricamento di file e il testo grezzo non sono attualmente supportati. Se la tua organizzazione ha requisiti di conformita o sicurezza che impediscono l’hosting pubblico, crea un ticket di supporto per discutere le opzioni di integrazione aziendale.

Avvio rapido

1. Ottieni un abbonamento PRO su app.podhoc.com
2. Crea un token API su app.podhoc.com/account/api-access
3. Invia la tua prima richiesta usando gli esempi qui sotto

Autenticazione

Tutte le richieste API richiedono un header X-Api-Key con il tuo token:

X-Api-Key: phk_test_a1b2c3d4e5f6...

URL base: https://api-ext.podhoc.com/v1

Tipi di token:

• Token di test (phk_test_...) – Piu economico, funzioni limitate. Per sviluppo e test.
• Token di produzione (phk_prod_...) – Piu costoso, accesso completo. Per uso in produzione.

Endpoint

POST /v1/podcasts – Creare un podcast

Avvia la generazione di un nuovo podcast da una o piu fonti.

curl -X POST https://api-ext.podhoc.com/v1/podcasts \
  -H "X-Api-Key: phk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article"],
    "language": "it",
    "target_duration_minutes": 10,
    "style": "deep_dive"
  }'

Identificatori style validi – esattamente questi nove e nessun altro:

deep_dive, critique, didactic, debate, feynman_technique, simplified_explanation, pedagogical_framework, alchemist_formula, references_recall

Qualsiasi altro valore fornito esplicitamente restituisce 400 INVALID_STYLE. Omettere il campo, o inviare null o una stringa vuota, usa deep_dive come predefinito. Inoltre references_recall (Riepilogo di Riferimenti e Dati Chiave) richiede un piano Creator o Pro: qualsiasi altro piano riceve 403 TIER_FEATURE_BLOCKED. Vedi la guida agli stili audio per cosa produce ciascuno.

GET /v1/podcasts/{id}/status – Controllare lo stato della generazione

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
  -H "X-Api-Key: phk_test_..."

Valori di stato: requested, processing, completed, failed.

GET /v1/podcasts/{id}/download – Scaricare il podcast

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download \
  -H "X-Api-Key: phk_test_..."

GET /v1/estimate-cost – Stimare il costo in crediti

curl "https://api-ext.podhoc.com/v1/estimate-cost?duration_minutes=30&source_count=2&voice_count=2" \
  -H "X-Api-Key: phk_test_..."

GET /v1/account/credits – Verificare il saldo crediti

curl https://api-ext.podhoc.com/v1/account/credits \
  -H "X-Api-Key: phk_test_..."

Prezzi

La generazione di podcast utilizza prezzi dinamici basati sui crediti. La API applica un moltiplicatore aggiuntivo in base al tipo di token.

Formula:

Costo base:          max(30, ceil(durata_minuti x 2.5))
Bonus:               + 20 se piu di 1 fonte
                     + 10 se pesi personalizzati abilitati
Scalatura voci:      x 1.2 se piu di 1 voce
Limite:              min(500, costo_max_del_tier)
Costo API:           crediti_base x moltiplicatore_crediti

Esempi di costo per durata (1 fonte, 1 voce, senza pesi personalizzati):

Moltiplicatori crediti:

I moltiplicatori di crediti (Piu economico per test, Piu costoso per produzione) sono i livelli predefiniti. Possono essere modificati – il moltiplicatore effettivo applicato alla tua richiesta viene mostrato nei metadati della risposta.

Limiti di velocita

Codici di errore

Token di test vs produzione