Podhoc API-Dokumentation

Integrieren Sie die Podcast-Generierung in Ihre Anwendungen

Podhoc bietet im Pro-Tarif eine REST-API für die Generierung aus URLs. Google Cloud dokumentiert eine Preview-API für Audio Overviews aus Notebooks und eine eigenständige Podcast-API. Einrichtung, Authentifizierung und Grenzen unterscheiden sich. Lesen Sie vor einer Integration die aktuelle Dokumentation.

Audio-API von Google Cloud. Vergleich geprüft am 16. September 2026.

Veröffentlichung als Standard: Bei Produktionstokens entspricht ein fehlendes auto_publish dem Wert true: Der erzeugte Podcast kann in Discover öffentlich sein. Senden Sie ausdrücklich "auto_publish": false, um private Ausgabe anzufordern; das Konto muss die Veröffentlichungssteuerung erlauben. Testtokens verwenden standardmäßig false und können nicht automatisch veröffentlichen. Private Quellen machen das erzeugte Audio nicht automatisch privat.

Breaking Change – style wird jetzt validiert. Ein ausdrücklich übergebener style, der nicht zu den neun kanonischen Ids gehört, gibt jetzt 400 INVALID_STYLE zurück. Bis zu dieser Änderung wurde ein nicht erkannter Wert stillschweigend akzeptiert und als deep_dive generiert. Frühere Fassungen dieser Seite verwendeten in den Beispielen "style": "conversational" — conversational war nie eine echte Style-Id, diese Aufrufe erzeugten also die ganze Zeit deep_dive, und das empfangene Audio war nicht das, was die Dokumentation nahelegte. Ersetzen Sie jeden nicht erkannten Wert durch eine kanonische Id. style wegzulassen oder null bzw. einen leeren String zu senden, verwendet weiterhin deep_dive als Vorgabe.

Inhaltsquellen: Die API akzeptiert ausschließlich öffentlich zugängliche URLs. Datei-Uploads und Rohtext werden derzeit nicht unterstützt. Wenn Ihre Organisation Compliance- oder Sicherheitsanforderungen hat, die ein öffentliches Hosting verhindern, erstellen Sie bitte ein Support-Ticket, um Enterprise-Integrationsoptionen zu besprechen.

Schnellstart

1. PRO-Abonnement abschließen auf app.podhoc.com
2. API-Token erstellen auf app.podhoc.com/account/api-access
3. Erste Anfrage senden mit den untenstehenden Beispielen

Authentifizierung

Alle API-Anfragen erfordern einen X-Api-Key-Header mit Ihrem Token:

X-Api-Key: phk_test_a1b2c3d4e5f6...

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

Token-Typen:

• Test-Tokens (phk_test_...) – Günstiger, eingeschränkte Funktionen. Für Entwicklung und Tests.
• Produktions-Tokens (phk_prod_...) – Teurer, voller Zugang. Für den Produktionseinsatz.

Endpunkte

POST /v1/podcasts – Podcast erstellen

Starten Sie die Generierung eines neuen Podcasts aus einer oder mehreren Quellen.

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

Gültige style-Ids – genau diese neun und keine anderen:

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

Jeder andere ausdrücklich übergebene Wert gibt 400 INVALID_STYLE zurück. Das Feld wegzulassen oder null bzw. einen leeren String zu senden, verwendet deep_dive. Zusätzlich setzt references_recall (Referenzen- und Kerndaten-Rückblick) einen Creator- oder Pro-Tarif voraus: jeder andere Tarif erhält 403 TIER_FEATURE_BLOCKED. Siehe den Leitfaden zu den Audio-Stilen, was jeder einzelne liefert.

GET /v1/podcasts/{id}/status – Generierungsstatus abfragen

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

Statuswerte: requested, processing, completed, failed.

GET /v1/podcasts/{id}/download – Podcast herunterladen

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

GET /v1/estimate-cost – Kosten schätzen

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 – Guthaben abfragen

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

Preise

Die Podcast-Generierung verwendet dynamische Credit-Preise. Die API wendet je nach Token-Typ einen zusätzlichen Multiplikator an.

Formel:

Basiskosten:         max(30, ceil(Dauer_Minuten x 2.5))
Bonusse:             + 20 bei mehr als 1 Quelle
                     + 10 bei aktivierten benutzerdefinierten Gewichtungen
Stimmen-Skalierung:  x 1.2 bei mehr als 1 Stimme
Obergrenze:          min(500, maximale_Tier-Kosten)
API-Kosten:          Basis-Credits x Credit-Multiplikator

Kostenbeispiele nach Dauer (1 Quelle, 1 Stimme, ohne benutzerdefinierte Gewichtungen):

Credit-Multiplikatoren:

Die Credit-Multiplikatoren (Günstiger für Test, Teurer für Produktion) sind die Standardstufen. Diese können angepasst werden – der tatsächlich angewandte Multiplikator wird in den Antwort-Metadaten angezeigt.

Ratenlimits

Fehlercodes

Test- vs. Produktions-Tokens