# Voz Studio

> O Voz Studio transforma roteiros em narração com IA em português brasileiro. Entrega áudio WAV, legendas SRT/VTT e timestamps por palavra em JSON para edição de vídeos. Funciona no navegador e por API.

## Produto

- Site oficial: https://voz.iagocavalcante.com/
- Guia de uso: https://voz.iagocavalcante.com/guia/narracao-ia-pt-br
- Perguntas frequentes: https://voz.iagocavalcante.com/#duvidas
- Plano beta Criador 30 dias: R$ 69,90 por período, 120 gerações e 360.000 caracteres. Sem renovação automática. Consulte o catálogo antes de comprar.
- Cadastro e demonstração gratuitos; gerar roteiros próprios exige plano pago.
- Voz disponível: Leni, em português brasileiro. Não oferece clonagem de voz.
- Entrega narração e sincronização; não cria cenas, não renderiza MP4 e não publica vídeos.
- A duração de três minutos por vídeo é uma estimativa. O limite por roteiro é 3.000 caracteres.
- Não há garantia de conclusão imediata; o processamento é assíncrono.


## Descoberta

- [Contrato OpenAPI](https://voz.iagocavalcante.com/openapi.json): endpoints, schemas, autenticação e idempotência.
- [Planos](https://voz.iagocavalcante.com/v1/plans): consulte preço, franquia e readiness. O preço beta pode mudar antes da compra; a compra guarda a oferta aceita.

## Fluxo para o agente

1. POST /v1/accounts com {"name":"Nome do canal"}. Guarde api_key em um gerenciador de segredos. A chave só é exibida nesta resposta. Uma conta de automação não verifica identidade por email. Não publique a chave nem a coloque em URLs.
2. Use Authorization: Bearer SUA_API_KEY em todas as chamadas privadas, inclusive downloads.
3. GET /v1/me informa saldo e validade. GET /v1/plans informa preço e disponibilidade.
4. Se precisar de franquia, peça autorização do pagador para o plano/valor. POST /v1/purchases exige Idempotency-Key e {"plan_id":"creator_30","max_amount_cents":VALOR_MAXIMO_AUTORIZADO}. Não aumente esse limite automaticamente. A resposta contém payment.brCode e payment.brCodeBase64.
5. Criar o Pix NÃO paga o Pix. Apresente ao pagador ou use uma carteira já autorizada por ele para esse valor e destinatário. Esta API não acessa bancos, não movimenta a conta do cliente, não armazena cartão e não executa débito automático.
6. GET /v1/purchases/ID consulta o pagamento. Só status paid libera a franquia. O servidor também reconcilia em segundo plano, mesmo sem navegador aberto. Repetir a consulta não duplica créditos.
7. POST /v1/generations com Idempotency-Key estável por versão e {"text":"Seu *roteiro* em português."}. HTTP 202 retorna um job; nenhuma geração é síncrona. A mesma chave e o mesmo texto retornam o mesmo job sem nova reserva. Chave já usada com outro texto retorna 409.
8. Consulte status_url a cada 5–10 segundos. queued → processing → completed ou failed. Até três jobs em andamento por conta; em 429, respeite Retry-After.
9. completed retorna files com caminhos relativos. Baixe com a mesma API key. Integre voz.wav, palavras.json e info.json ao seu editor ou pipeline de vídeo; use o mesmo roteiro. SRT/VTT são por segmento, palavras.json é por palavra em segundos: [[palavra,inicio,fim,destaque],...].
10. Em falha técnica, caracteres e geração reservados voltam ao período original uma única vez; a tentativa técnica é consumida. POST retry_url reserva novamente, sem gerar Pix. Máximo de três tentativas por job e 180 tentativas totais por período. Uma falha antiga não credita um período novo. Revise falhas persistentes; não faça loops de novas contas ou jobs.

## Plano Criador 30 dias

- 120 gerações, 360.000 caracteres, até 3.000 por roteiro, até 40 segmentos por roteiro, 30 dias a partir da confirmação do pagamento.
- Pensado para 90 vídeos de até três minutos e ajustes. Duração é uma estimativa; os limites cobrados são caracteres e gerações, não minutos ou vídeos efetivamente publicados.
- Reescrever um roteiro e enviar nova chave consome outra geração. Somente o texto falado, sem asteriscos de destaque e com espaços normalizados, consome caracteres.
- Sem renovação automática, débito automático ou excedente cobrado. Franquia não acumula. Pode comprar outro período quando o anterior expirar ou estiver esgotado; ele substitui o saldo anterior.
- HTTP 402 inclui payment_action. Nunca crie cobrança nem pague sem autorização vigente. HTTP 409 pode indicar conflito de idempotência ou plano ainda ativo.
- Após resposta perdida, consulte GET /v1/purchases ou GET /v1/generations e reutilize a chave original. Não gere novas chaves para esconder erros.
- Histórico: GET /v1/generations?page=1 retorna 30 registros e next_page; percorra as páginas para baixar os 90 vídeos. Guarde também os IDs e status_url. Compras retornam os 30 registros mais recentes.

## Limites de operação

Sem clonagem de voz, postagem em redes sociais, agendamento de publicações ou geração de cenas. Os agentes do cliente cuidam da cadência de três vídeos por dia. A voz e o alinhamento precisam de revisão antes da publicação. Não há SLA de latência; inicialização a frio pode levar minutos. Não transfira roteiros com dados sensíveis sem autorização do dono.

Gerações expõem stage (synthesizing, aligning, packaging); status determina conclusão. O mapa files inclui narracao.zip, com áudio e legendas; todos os downloads exigem a mesma autenticação. Uma nova chave emitida no estúdio revoga a anterior.

Quando o catálogo inclui CARD, novas compras retornam payment.kind=checkout e payment.url para o checkout hospedado com Pix ou cartão em 1x, pelo mesmo preço. Abra o link para o titular autorizar; não solicite número do cartão nem CVV. Voltar do checkout não prova pagamento: consulte /v1/purchases/{id} até paid. Sem configuração de cartão, permanece o QR Pix transparente.