Documentation API Podhoc

Integrez la generation de podcasts dans vos applications

L’API Podhoc vous permet de creer des podcasts generes par IA de maniere programmatique a partir d’URLs accessibles publiquement. Integrez la generation de podcasts dans vos workflows, applications et plateformes.

Sources de contenu : L’API accepte uniquement les URLs accessibles publiquement. Le telechargement de fichiers et le texte brut ne sont pas pris en charge actuellement. Si votre organisation a des exigences de conformite ou de securite qui empechent l’hebergement public, veuillez creer un ticket de support pour discuter des options d’integration entreprise.

Demarrage rapide

1. Souscrivez un abonnement PRO sur app.podhoc.com
2. Creez un jeton API sur app.podhoc.com/account/api-access
3. Envoyez votre premiere requete avec les exemples ci-dessous

Authentification

Toutes les requetes API necessite un en-tete X-Api-Key avec votre jeton :

X-Api-Key: phk_test_a1b2c3d4e5f6...

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

Types de jetons :

• Jetons de test (phk_test_...) – Moins cher, fonctions limitees. Pour le developpement et les tests.
• Jetons de production (phk_prod_...) – Plus cher, acces complet. Pour l’utilisation en production.

Points d’acces

POST /v1/podcasts – Creer un podcast

Lancez la generation d’un nouveau podcast a partir d’une ou plusieurs sources.

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": "fr",
    "target_duration_minutes": 10,
    "style": "conversational"
  }'

GET /v1/podcasts/{id}/status – Consulter le statut de generation

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

Valeurs de statut : requested, processing, completed, failed.

GET /v1/podcasts/{id}/download – Telecharger le 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 – Estimer le cout en credits

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 – Verifier le solde de credits

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

Tarifs

La generation de podcasts utilise une tarification dynamique basee sur les credits. L’API applique un multiplicateur supplementaire selon le type de jeton.

Formule :

Cout de base :          max(30, ceil(duree_minutes x 2.5))
Bonus :                 + 20 si plus d'1 source
                        + 10 si poids personnalises actives
Mise a l'echelle voix : x 1.2 si plus d'1 voix
Plafond :               min(500, cout_max_du_tier)
Cout API :              credits_base x multiplicateur_credits

Exemples de cout par duree (1 source, 1 voix, sans poids personnalises) :

Multiplicateurs de credits :

Les multiplicateurs de credits (Moins cher pour test, Plus cher pour production) sont les niveaux par defaut. Ceux-ci peuvent etre ajustes – le multiplicateur reel applique a votre requete est affiche dans les metadonnees de la reponse.

Limites de debit

Codes d’erreur

Jetons de test vs production