api.podkst.ai · v1
Voz nativa. Dois idiomas.
Uma chamada de API.
Integre narração PT-BR e EN-US em seu agente, produto ou pipeline. 30 vozes neurais multi-idioma, latência previsível, preço por minuto.
OpenAPI 3.1 · MCP Server · webhooks HMAC-SHA256 · llms.txt
curl -X POST https://api.podkst.ai/v1/generations \
-H "x-api-key: ${PODKST_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"input": "Mercado brasileiro de IA em 2026",
"tier": "regular",
"language": "pt-BR",
"style": "conversational",
"speakers": [
{"voice": "Nina", "tone": "analytical"},
{"voice": "Kai", "tone": "enthusiastic"}
],
"tts_quality": "standard",
"research": true
}'
# Response — 200 OK
# {
# "id": "gen_Q0WC2DrqQVN7",
# "status": "queued",
# "urls": { "get": "…/v1/generations/gen_Q0WC2DrqQVN7" }
# }- P50 <500ms
- 32 req/s
- 99.5% uptime
- PT-BR nativo
- MCP compatible
- llms.txt
- LGPD compliant
O que você recebe
Três superfícies, um contrato.
REST API
POST /v1/generations, GET /v1/generations/:id. OpenAPI 3.1, idempotency keys, paginação cursor-based. Pronto hoje.
MCP Server
Servidor MCP para Claude Desktop, Cursor e Claude Code. 37 tools: podkst_generate, podkst_generate_from_script, podkst_generate_monologue, podkst_status, podkst_voices, podkst_cancel, podkst_credits, e mais 30 studio_* para editar, mixar e masterizar no Studio. Lista completa em /llms.txt. npx -y @podkst/mcp-server.
Webhooks
Callback ao terminar a geração. Assinatura HMAC-SHA256. Uma tentativa por evento, sem reenvio. Se o callback falhar, consulte GET /v1/generations/:id.
podkst Studio
podkst Studio: corrija uma fala sem refazer o episódio
O podkst Studio transforma um roteiro em um projeto de áudio. Cada fala vira uma peça com áudio e versões próprias. Você troca uma frase, gera de novo só aquela fala, põe sua trilha por baixo e exporta um master pronto para publicar. Funciona pela API REST em /v1/studio e pelas tools studio_* do servidor MCP.
Uma peça por fala
Cada linha do roteiro vira uma fala com áudio próprio. O que estiver entre colchetes, como [surpreso], vira a direção da fala e não é lido. Gerar de novo cria uma versão nova. As 5 mais recentes ficam guardadas, e voltar para uma antiga não gasta crédito.
Edição com versão, por API ou agente
Você edita por operações (set_text, set_direction, set_voice, insert_segment e outras) que apontam para o id da fala, com a versão no header If-Match. Se o projeto mudou antes, a API responde 412 em vez de sobrescrever. No MCP, cada operação é uma tool, com desfazer e refazer.
Trilha e vinheta suas
Envie MP3, WAV, OGG ou FLAC de até 25 MB e 10 minutos, confirmando o direito de uso. Cada áudio fica preso a uma fala, com loop e fade. Se a fala cresce, a trilha se move junto. A trilha abaixa 7 dB por padrão enquanto alguém fala.
Master medido no arquivo final
MP3 estéreo a -16 LUFS, MP3 mono a -19 LUFS ou WAV 24 bits, com pico até -1 dBTP. O podkst Studio mede o arquivo depois de codificado, e a resposta traz o loudness, o pico e o início e o fim de cada fala.
Do roteiro ao master
- 01
Crie o projeto
Mande o título, o roteiro no formato Nome: fala e uma voz para cada nome. As falas começam a ser geradas na hora.
POST /v1/studio/projects { "title": "...", "script": "Nina: [acolhedora] Oi!\nKai: E aí?", "voices": { "Nina": "builtin:Nina", "Kai": "builtin:Kai" } } → 202 { "project": { "id": "prj_…", "version": 1 }, "job_id": "sjob_…" } - 02
Corrija só o que precisa
Mude a direção de uma fala e gere de novo só ela.
PATCH /v1/studio/projects/prj_… If-Match: "2" { "ops": [{ "op": "set_direction", "segment_id": "seg_…", "direction": "surpreso" }] } - 03
Exporte o master
O resultado do job traz a URL e as medições.
POST /v1/studio/projects/prj_…/master { "preset": "podcast-stereo" } → { "status": "succeeded", "result": { "url", "integrated_lufs", "true_peak_dbtp", "lines" } }
Perguntas sobre o podkst Studio
- O que é o podkst Studio?
- É a parte da API do podkst que transforma um roteiro em um projeto de áudio editável. Cada fala vira uma peça separada, com áudio e versões próprias. Você edita as falas, adiciona trilha e vinheta e exporta um master, pela API REST ou pelo servidor MCP.
- Preciso gerar o episódio de novo para corrigir uma frase?
- Não. Você gera de novo só a fala que quer corrigir. As outras continuam com o mesmo áudio, e só o áudio da fala nova entra na conta do projeto.
- Quanto custa?
- O podkst Studio soma a duração real do áudio de todas as falas geradas no projeto, contada em milissegundos e não em segundos inteiros, e arredonda para cima uma vez só, no total do projeto, a 2 créditos por minuto na voz standard, sem mínimo por fala. Um projeto com 200,5 segundos de áudio na voz standard custa 7 créditos. A voz pro custa 2×. Gerar de novo uma fala soma ao total só o áudio do take novo, e você paga o quanto isso aumenta o total arredondado, que pode ser zero. Prévia, master, upload e voltar para uma versão antiga não gastam crédito. No cadastro você ganha 50 créditos, uma vez só, sem cartão. A compra é só com Pix. Os valores atuais estão em GET /v1/pricing.
- Posso usar minha trilha e minha vinheta?
- Sim. Envie MP3, WAV, OGG ou FLAC de até 25 MB e 10 minutos e confirme que tem direito de uso. O podkst Studio nivela o volume de cada arquivo, abaixa a trilha quando alguém fala e faz os fades. Ele não gera música nem efeitos.
- Qual o volume do arquivo final?
- No preset padrão, MP3 estéreo a -16 LUFS, com pico até -1 dBTP. Também há MP3 mono a -19 LUFS e WAV 24 bits. O podkst Studio mede o arquivo depois de codificado, e a resposta traz os números.
- Tem editor visual?
- Não. O podkst Studio é usado pela API REST e pelo servidor MCP.
Preço por minuto
R$0,12/min
A partir de 2 cr/min (Essential, voz standard). Pacotes de 100 a 2.000 créditos, de R$0,06 a R$0,10 por crédito. O menor preço por minuto vale no pacote de 2.000.
Ponto de comparação
- Estúdio tradicional (BR)~R$ 50/min
- ElevenLabs (EN, volume)~R$ 0,45/min
- podkst.ai PT-BR / EN-USa partir de R$0,12/min
Já tem um script pronto?
Modo script_to_audio: 2 cr/min (standard) / 4 cr/min (pro). Duração estimada: palavras ÷ 150. Um script de 1.500 palavras ≈ 10 min ≈ 20 créditos (standard). Sem LLM, só TTS.
Quickstart
Três passos até o primeiro MP3.
- 01
Autentique
Obtenha uma API key no dashboard. Cada requisição carrega a chave no header `x-api-key` — mantenha-a no servidor, nunca envie para o navegador.
curl https://api.podkst.ai/v1/credits \ -H "x-api-key: $PODKST_API_KEY" - 02
Solicite um episódio
Envie tema, vozes e tier de profundidade. A API retorna o ID da geração em milissegundos.
POST /v1/generations → { "id": "gen_…", "status": "queued" } - 03
Receba o áudio
Webhook ao completar, ou polling em GET /v1/generations/:id. Download direto via audio_url.
GET /v1/generations/:id → { "status": "succeeded", "output": { "audio_url", "duration_seconds" } }
Escopos de API key
Escopo mínimo por caso de uso.
generate:podcast agora implica leitura dos jobs que a própria chave criou. Leitura entre chaves (observabilidade) continua exigindo read:jobs.
- Agente autônomo (gerar + ler os próprios jobs)generate:podcast
- Agente que também registra webhooksgenerate:podcast, manage:webhooks
- Dashboard que lista vozesread:voices
- Dashboard que mostra saldobilling:read
- Observabilidade / inspeção entre chavesread:jobs
Uma chave com apenas generate:podcast pode ler os jobs que ela mesma criou, mas não os jobs criados por outra chave da mesma conta — isso continua exigindo read:jobs.
Catálogo
30 vozes neurais em português e inglês.
Amostra · catálogo completo em GET /v1/voices
- NinaFFirm
- KaiMUpbeat
- LunaFBreezy
- LeoMInformative
- AriaFBright
- MaxMFirm
- RosaFWarm
- SorenMKnowledgeable
Catálogo completo via GET /v1/voices · novas vozes adicionadas regularmente.
Documentação completa
Tudo que você precisa pra shippar.
OpenAPI 3.1, exemplos em curl, Node.js e Python, guias de integração, changelog público e status page.