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 · POST /v1/generations
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.

Beta

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

  1. 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_…" }
  2. 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" }] }
  3. 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.

  1. 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"
  2. 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" }
  3. 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.

Cookies de análise

Com a sua permissão, usamos o Google Analytics e o Microsoft Clarity, que grava como você navega nas páginas, para entender o uso do site. Também guardamos a campanha de onde você veio. Se você recusar, nada disso é carregado. Você pode mudar a escolha em “Preferências de cookies”, no rodapé. Política de Privacidade

podkst.ai para desenvolvedores — API de voz PT-BR e EN-US