Documentacio de l'API de Podhoc

Integra la generacio de podcasts a les teves aplicacions

L’API de Podhoc et permet crear podcasts generats per IA de forma programatica a partir d’URLs d’acces public. Integra la generacio de podcasts als teus fluxos de treball, aplicacions i plataformes.

Fonts de contingut: L’API accepta nomes URLs d’acces public. La carrega de fitxers i el text sense format no estan suportats actualment. Si la vostra organitzacio te requisits de compliment o seguretat que impedeixen l’allotjament public, creeu un tiquet de suport per discutir opcions d’integracio empresarial.

Inici rapid

1. Aconsegueix una subscripcio PRO a app.podhoc.com
2. Crea un token d’API a app.podhoc.com/account/api-access
3. Fes la teva primera peticio utilitzant els exemples de sota

Autenticacio

Totes les peticions a l’API requereixen una capcalera X-Api-Key amb el teu token:

X-Api-Key: phk_test_a1b2c3d4e5f6...

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

Tipus de token:

• Tokens de prova (phk_test_...) – Mes economic, funcions limitades. Per a desenvolupament i proves.
• Tokens de produccio (phk_prod_...) – Mes costos, acces complet. Per a us en produccio.

Endpoints

POST /v1/podcasts – Crear un podcast

Inicia la generacio d’un nou podcast a partir d’una o mes fonts.

Exemple de peticio:

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

GET /v1/podcasts/{id}/status – Consultar estat de generacio

Comprova el progres d’un podcast en generacio.

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

Valors d’estat: requested, processing, completed, failed.

GET /v1/podcasts/{id}/download – Descarregar podcast

Obte una URL de descarga prefirmada per a un podcast completat. La URL caduca en 1 hora.

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

GET /v1/estimate-cost – Estimar cost en credits

Previsualitza el cost en credits abans de crear un podcast.

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 – Consultar saldo de credits

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

Preus

La generacio de podcasts utilitza preus dinamics basats en credits. L’API aplica un multiplicador addicional segons el tipus de token.

Formula:

Cost base:          max(30, ceil(durada_minuts x 2.5))
Bonificacions:      + 20 si mes d'1 font
                    + 10 si s'habiliten pesos personalitzats
Escalat de veus:    x 1.2 si mes d'1 veu
Limit:              min(500, cost_maxim_del_tier)
Cost API:           credits_base x multiplicador_credits

Exemples de cost per durada (1 font, 1 veu, sense pesos personalitzats):

Multiplicadors de credits:

Els multiplicadors de credits (Mes economic per a test, Mes costos per a produccio) son els nivells per defecte. Poden ajustar-se – el multiplicador real aplicat a la teva sol-licitud es mostra a les metadades de la resposta.

Limits de velocitat

Codis d’error

Tokens de prova vs produccio