# Configurar o Lero Você está ajudando alguém a colocar a voz do Lero num projeto: voz de IA em português do Brasil, com sotaque do Rio, de São Paulo ou de Niterói. Faça o setup inteiro a partir deste prompt. A pessoa cria a conta, cria a chave e responde poucas perguntas; você faz o resto. Índice completo: [https://lero.studio/llms.txt](https://lero.studio/llms.txt). Referência da API: [https://lero.studio/docs/llms-full.txt](https://lero.studio/docs/llms-full.txt). Contrato: [https://lero.studio/docs/openapi.json](https://lero.studio/docs/openapi.json). Os links de páginas do site aceitam `.md` no fim, ou o header `Accept: text/markdown`, e devolvem Markdown. ## Antes de começar - **Responda primeiro.** A sua primeira mensagem são as perguntas do passo 1. Antes dela, leia só arquivos locais que ajudam a adivinhar as respostas (package.json, .env.example, código que já gera áudio). Não pesquise na web ainda. - **Abra a documentação só quando um passo pedir.** Não leia adiantado. - **Saiba onde você roda.** - Com o projeto e um terminal (Claude Code, Codex, Cursor, Conductor): siga todos os passos. - Num chat sem o projeto (Claude, ChatGPT): pule os palpites do projeto e entregue o código para a pessoa colar. ## 1. Pergunte o que a pessoa quer Numa mensagem só, já com o seu melhor palpite, para a pessoa responder "ok" ou trocar um valor: 1. **O que vai montar?** Pode ser mais de um. - **Voz no produto:** o app gera fala pela API (aviso, leitura de texto, URA, acessibilidade, narração). - **Áudios e podcasts pelo agente:** você mesmo gera narrações e episódios pelo MCP do Lero, sem código no projeto. - **Agente de voz ao vivo:** uma conversa por WebRTC com o system prompt e o conhecimento da pessoa. 2. **Qual voz?** `rio` (carioca), `sp` (paulista) ou `niteroi` (niteroiense). Na dúvida, gere a mesma frase nas três. 3. **Acesso:** a pessoa precisa de uma conta e de uma chave (passo 2). ## 2. Pegue o acesso - **Conta:** sem conta, a pessoa cria em [https://app.lero.studio/cadastro](https://app.lero.studio/cadastro). O plano Grátis tem 10 mil créditos por mês; a API e o MCP estão nos planos Creator e Dev. - **Chave:** a pessoa cria em [https://app.lero.studio/desenvolvedores?aba=chaves](https://app.lero.studio/desenvolvedores?aba=chaves) e guarda como `LERO_API_KEY` no ambiente (o .env do projeto, o secret do deploy ou a variável do terminal). Nunca peça a chave no chat. Se a pessoa colar uma chave, não use: diga para revogar essa e criar outra. - **MCP** (para gerar áudios pelo agente). Prefira o remoto: a pessoa entra com a conta do Lero (OAuth) e nenhuma chave passa pelo chat. Conecte direto, sem procurar: - Claude Code: `claude mcp add --transport http lero https://mcp.lero.studio/mcp`, depois `/mcp` para entrar. - Codex: `codex mcp add lero --url https://mcp.lero.studio/mcp` - Claude (web ou desktop): Configurações → Conectores → Adicionar conector personalizado → `https://mcp.lero.studio/mcp` - Cursor, Conductor ou outro cliente MCP: `https://mcp.lero.studio/mcp` como servidor MCP remoto. O manifesto está em [https://lero.studio/.well-known/mcp.json](https://lero.studio/.well-known/mcp.json). - Sem OAuth, o MCP local com a chave em `LERO_API_KEY`: `claude mcp add --env LERO_API_KEY=$LERO_API_KEY lero -- npx -y lero-mcp` - **Skill** (opcional, para agentes que aceitam Agent Skills): `mkdir -p ~/.claude/skills/lero-api && curl -fsSL https://lero.studio/docs/skill.md -o ~/.claude/skills/lero-api/SKILL.md` ## 3. Monte o que a pessoa escolheu ### Voz no produto - `POST https://app.lero.studio/api/v1/tts` com `{"texto": "...", "voz": "rio"}` devolve o MP3 (`audio/mpeg`). Com `Accept: application/json`, o áudio vem em base64 no campo `audio`. - De 1 a 500 caracteres por pedido. Para texto longo, divida nas frases, gere cada parte e junte os MP3 na ordem. - Chame do servidor, com a chave lida de `LERO_API_KEY`. Nunca exponha a chave no navegador ou no app. - Trate `402 sem_credito`, `429 muitos_pedidos` e `429 ocupado` (respeite o `Retry-After`) e `503 carregando` (tente de novo em alguns segundos). - 1 crédito por caractere. O header `X-Creditos-Restantes` traz o saldo depois de cada pedido. ### Áudios e podcasts pelo agente - O MCP tem as ferramentas `lero_fala`, `lero_transcrever` (só no remoto), `lero_vozes` e `lero_saldo`. No remoto, `lero_fala` devolve o áudio e um link de download que vale 1 hora: baixe com `curl -o`. No local, o MP3 sai em `~/Downloads/Lero`, ou na pasta de `LERO_PASTA`. - Podcast: escreva o roteiro, divida em falas de até 500 caracteres, alterne as vozes, gere cada fala e, se a pessoa tiver ffmpeg, junte tudo num arquivo só. ### Agente de voz ao vivo - `GET https://app.lero.studio/api/v1/agents` lista as versões, os LLMs, as vozes e o setup recomendado. `POST https://app.lero.studio/api/v1/agents/conversation` recebe a SDP offer do seu client WebRTC e devolve a SDP answer. Passo a passo: [https://lero.studio/docs#agente-guia](https://lero.studio/docs#agente-guia). ## 4. Teste - Gere uma frase curta com a voz escolhida e toque, ou diga onde o arquivo ficou. - Confira o saldo com `GET https://app.lero.studio/api/v1/balance`. ## 5. Relate Diga o que ficou pronto, o nome da variável da chave (nunca o valor), a voz escolhida, quanto o teste gastou em créditos e o próximo passo. ## Se o projeto já usa outro serviço de voz - ElevenLabs: siga [https://lero.studio/migrar/elevenlabs.md](https://lero.studio/migrar/elevenlabs.md). - Outro serviço: troque a chamada pela `POST /v1/tts`, mapeie o id da voz para `rio`, `sp` ou `niteroi` e divida os textos acima de 500 caracteres. ## Ajuda Documentação: [https://lero.studio/docs](https://lero.studio/docs). Preços: [https://lero.studio/precos.md](https://lero.studio/precos.md). Contato: oi@lero.studio, com o `X-Pedido-Id` do pedido que falhou.