# Lero Docs

> O Lero transforma texto em fala em português do Brasil, com sotaque. A API do Lero recebe o texto e a voz e devolve um MP3, com as vozes rio (Rio de Janeiro), sp (São Paulo) e niteroi (Niterói). O Speech-to-Text transcreve áudio em português do Brasil, com o tempo de cada frase e legenda pronta. O Conversational Agent é um voice agent ao vivo por WebRTC, com o seu system prompt e knowledge base. O MCP do Lero coloca essa voz dentro do Claude Code, do Codex, do Cursor e do Claude Desktop.

Base URL: https://app.lero.studio/api/v1. Autenticação: `Authorization: Bearer lero_...`. TTS: 1 crédito por caractere. STT: 150 créditos por minuto de áudio. Versão em inglês: https://lero.studio/docs/en/llms.txt

## Documentação

- [Referência da API](https://lero.studio/docs): integração direta, início rápido, chave, erros, limites e as rotas (TTS, STT e Conversational Agent).
- [Build with AI](https://lero.studio/docs/ai): o MCP, o prompt de integração, docs para agentes e a skill.
- [llms-full.txt](https://lero.studio/docs/llms-full.txt): a documentação inteira em um arquivo Markdown.
- [openapi.json](https://lero.studio/docs/openapi.json): contrato OpenAPI 3.1 das rotas.
- [prompt.md](https://lero.studio/docs/prompt.md): prompt para colar no seu agente de código.
- [skill.md](https://lero.studio/docs/skill.md): Agent Skill `lero-api` para agentes de código.
- [MCP](https://lero.studio/docs/ai#mcp): servidor MCP por stdio, `npx -y lero-mcp`, com a chave em `LERO_API_KEY`.

## Começar

- [Integração direta](https://lero.studio/docs#integracao)
- [Início rápido](https://lero.studio/docs#inicio)
- [Chave](https://lero.studio/docs#chave)
- [Erros](https://lero.studio/docs#erros)
- [Créditos e limites](https://lero.studio/docs#limites)

## Rotas

- [Gerar fala](https://lero.studio/docs#fala): `POST /v1/tts`. Transforma o texto em fala e devolve o MP3 (`audio/mpeg`). Custa 1 crédito por caractere do texto, cobrado antes de gerar e devolvido se a geração falhar.
- [Listar vozes](https://lero.studio/docs#vozes): `GET /v1/voices`. A lista das vozes, com o id e o nome. Não gasta crédito.
- [Transcrever áudio](https://lero.studio/docs#transcricao): `POST /v1/stt`. Transforma o áudio em texto, no português falado do Brasil: gírias, siglas, números e nomes no lugar. Devolve o texto com parágrafos e as frases com o tempo de início e fim; se você pedir, o tempo de cada palavra ou a legenda pronta (SRT ou VTT).
- [Ver saldo](https://lero.studio/docs#saldo): `GET /v1/balance`. Os créditos da conta agora, já com a franquia do mês, e o plano. Não gasta crédito.
- [Listar versões e LLMs](https://lero.studio/docs#agentes): `GET /v1/agents`. O discovery do Conversational Agent: as versões do agente que a sua chave pode usar, os LLMs, as vozes e o setup recomendado. Chame antes de abrir a conversa: a lista muda. Não gasta crédito.
- [Abrir conversa (WebRTC)](https://lero.studio/docs#conversa): `POST /v1/agents/conversation`. O signaling da conversa ao vivo: você manda a SDP offer do seu client WebRTC e recebe a SDP answer. Depois, o áudio e o data channel `chat` vão peer-to-peer entre o seu client e o agente (STT, LLM e TTS em streaming, com barge-in e turn detection). Sem `versao`, `llm` e `voz`, vale o recomendado. Com `instrucoes`, o agente vira o seu: o system prompt substitui a persona do Lero. Passo a passo em [Conversational Agent: passo a passo](#agente-guia).

## Mais

- [Webhooks](https://lero.studio/docs#webhooks)
- [Conversational Agent: passo a passo](https://lero.studio/docs#agente-guia)
- [Exemplos](https://lero.studio/docs#exemplos)
- [Suporte](https://lero.studio/docs#suporte)