Podcasts mit der Podhoc-API erzeugen: vollständige Anleitung
Erzeuge KI-Podcasts programmatisch mit der Podhoc-REST-API. Authentifizierung, Erstellen-Abfragen-Herunterladen-Lebenszyklus, Rate-Limits, Kreditschätzung.
Aktives Pro oder eine laufende Pro-Testmitgliedschaft ist für Test- und Produktionstokens erforderlich. Test-Tokens verbrauchen echte Credits und sind kein kostenloser Sandbox-Zugang. Schlüssel gehören auf deinen Server, nicht in Browsercode, URLs, Logs oder Git.
Quellen müssen unterstützte öffentlich erreichbare URLs sein. Uploads und eingefügter Text werden nicht akzeptiert. Veröffentliche dafür keine vertraulichen Dokumente.
Sichere erste Anfrage
Das Beispiel nutzt eine fiktive öffentliche Quelle und kostet Credits. Lies zuerst Guthaben und Kostenvorschau und genehmige ein Budget. Fünf Minuten mit einer Stimme kosten bei Standard-Testpreisen 72 Credits; bei abweichender Konfiguration gilt die zurückgegebene Vorschau.
Speichere vor jeder beabsichtigten Erstellung einen neuen Idempotency-Key. Wiederhole unklare Anfragen mit identischem Schlüssel und Inhalt: die ursprüngliche Bestätigung wird wiederverwendet. Geänderter Inhalt ergibt 409. Ein Timeout ist kein Grund für einen neuen Schlüssel.
Grenzen und Preise
Test: 2 Anfragen/Minute, 20/Stunde, 1 parallele Erstellung, höchstens 5 Minuten, 1 URL und Englisch. Produktion: 30/Minute, 300/Stunde, 5 parallel innerhalb der Pro-Grenzen. Bei 429 Retry-After beachten.
Basis: max(36, ceil(Minuten × 10 / 3)). Mehrere Quellen: +27 Credits; eigene Gewichte: +13; mehrere Standardstimmen: Faktor 1,2 mit Rundung und Generierungslimit. Danach API-Multiplikator: standardmäßig 2× Test, 3,5× Produktion; Laufzeitwerte können abweichen. 30 Minuten/eine Quelle/eine Stimme in Produktion: 100 × 3,5 = 350 Credits. Test erlaubt keine 30 Minuten.
Rufe estimate-cost mit gleichen Einstellungen auf; prüfe final_credits, credit_multiplier und Restguthaben. Dauer ist ungefähr; berechnet werden die gewünschten Einstellungen, nicht die endgültige Audio-Stoppuhr.
Status, Download und Fehler
Mit Test-Tokens höchstens alle 240 Sekunden und maximal 12-mal abfragen; Kapazität für andere Aufrufe reservieren. Produktion mit begrenztem Backoff und Raten-Headern. Bei weiter offenem Auftrag ID speichern und später fortsetzen, nicht doppelt erstellen. Diese Referenz verspricht keinen Abschluss-Webhook.
Erst bei completed herunterladen. Fehlergrund, Guthaben und Erstattung vor einem neuen Versuch prüfen. Download-URLs sind temporär und privat, keine dauerhaften öffentlichen Asset-Adressen.
Privat, veröffentlichen und löschen
Die Ausgabe ist standardmäßig öffentlich. Creator und Pro ermöglichen private Erstellung; private Folgen lassen sich später mit Rechtebestätigung veröffentlichen. Die Produktions-API beachtet die Wahl des Abonnenten; Test-Tokens dürfen nicht veröffentlichen. Sende für private Erstellung ausdrücklich auto_publish=false mit deinem Pro-Konto.