Comment générer des podcasts avec l'API Podhoc : guide complet
Générez des podcasts par IA de manière programmatique avec l'API REST Podhoc. Authentification, cycle créer-interroger-télécharger, limites de débit.
Pro actif ou en période d’essai est requis pour créer ou renouveler les jetons de test comme de production. Les tests consomment de vrais crédits : ce n’est pas un bac à sable gratuit. Gardez les clés côté serveur, hors navigateur, URL, journaux et dépôts.
Les sources sont des URL publiques compatibles. L’API n’accepte ni fichiers téléversés ni texte collé. Ne rendez pas publics des documents confidentiels pour l’utiliser.
Première requête sûre
L’exemple utilise une source publique fictive et consomme des crédits. Lisez solde et estimation puis approuvez un budget. Cinq minutes avec une voix coûtent 72 crédits au multiplicateur de test par défaut ; utilisez l’estimation retournée si la configuration diffère.
Enregistrez un nouvel Idempotency-Key pour chaque création voulue avant envoi. Réessayez une réponse incertaine avec la même clé et le même contenu : le reçu initial est renvoyé. Un contenu différent donne 409. Un timeout ne justifie pas une nouvelle clé.
Limites et prix
Test : 2 requêtes/minute, 20/heure, 1 création simultanée, 5 minutes maximum, 1 URL et anglais. Production : 30/minute, 300/heure et 5 simultanées selon Pro. Respectez Retry-After sur 429.
Base : max(36, ceil(minutes × 10 / 3)). Plusieurs sources : +27 crédits ; pondération : +13 ; plusieurs voix standard : ×1,2 avec arrondi et plafond applicable. Puis multiplicateur API : 2× test, 3,5× production par défaut, configurable. En production, 30 minutes/une source/une voix : 100 × 3,5 = 350 crédits. Un jeton de test ne permet pas 30 minutes.
Appelez estimate-cost avec les mêmes réglages ; vérifiez final_credits, credit_multiplier et solde restant. La durée est approximative ; le prix dépend des réglages demandés, pas du chronomètre final.
État, téléchargement et échec
En test, interrogez au plus toutes les 240 secondes, 12 fois maximum, en réservant des appels pour les autres requêtes. En production, attente bornée et respect des en-têtes. Si toujours en attente, gardez l’ID et reprenez plus tard sans recréer. Aucun webhook de fin n’est promis ici.
Téléchargez seulement après completed. Vérifiez motif d’échec, solde et remboursement avant un nouvel essai. L’URL temporaire est privée ; ne la publiez pas comme adresse permanente.
Confidentialité, publication et suppression
Le résultat est public par défaut. Creator et Pro permettent de choisir une création privée ; un épisode privé peut ensuite être publié après confirmation des droits. L’API de production respecte le choix de l’abonné ; les jetons de test ne peuvent pas publier. Pour créer en privé, envoyez explicitement auto_publish=false avec votre compte Pro.