Documentazione API Podhoc

Integra la generazione di podcast nelle tue applicazioni

La API Podhoc ti permette di creare podcast generati da IA in modo programmatico da URL accessibili pubblicamente. Integra la generazione di podcast nei tuoi flussi di lavoro, app e piattaforme.

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": "conversational"
  }'

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