Podhoc API-Dokumentation

Integrieren Sie die Podcast-Generierung in Ihre Anwendungen

Die Podhoc API ermoeglicht es Ihnen, KI-generierte Podcasts programmatisch aus oeffentlich zugaenglichen URLs zu erstellen. Integrieren Sie die Podcast-Generierung in Ihre Workflows, Apps und Plattformen.

Inhaltsquellen: Die API akzeptiert ausschliesslich oeffentlich zugaengliche URLs. Datei-Uploads und Rohtext werden derzeit nicht unterstuetzt. Wenn Ihre Organisation Compliance- oder Sicherheitsanforderungen hat, die ein oeffentliches Hosting verhindern, erstellen Sie bitte ein Support-Ticket, um Enterprise-Integrationsoptionen zu besprechen.

Schnellstart

1. PRO-Abonnement abschliessen 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_...) – Guenstiger, eingeschraenkte Funktionen. Fuer Entwicklung und Tests.
• Produktions-Tokens (phk_prod_...) – Teurer, voller Zugang. Fuer 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": "conversational"
  }'

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 schaetzen

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 zusaetzlichen 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 (Guenstiger fuer Test, Teurer fuer Produktion) sind die Standardstufen. Diese koennen angepasst werden – der tatsaechlich angewandte Multiplikator wird in den Antwort-Metadaten angezeigt.

Ratenlimits

Fehlercodes

Test- vs. Produktions-Tokens