# Migrar da ElevenLabs para o Lero

Guia para trocar a ElevenLabs pelo Lero em minutos: a rota, o header, as vozes, os limites, o MCP e o preço em real.

https://lero.studio/migrar/elevenlabs

## Introdução

Se você usa a ElevenLabs e o seu público é brasileiro, este guia mostra o que muda ao trocar para o Lero: a chamada da API, as vozes, os limites, o MCP e o preço. A troca leva poucos minutos: uma rota, um header e o nome da voz.

**Pule para:** [Conceitos](#conceitos) · [Gerar fala pela API](#gerar-fala-pela-api) · [Vozes](#vozes) · [Limites](#limites) · [MCP](#mcp) · [Agentes de voz](#agentes-de-voz) · [Preço](#preco) · [Checklist](#checklist)

## Quando vale a troca

- O seu público é brasileiro e o sotaque faz diferença: o Lero tem vozes carioca, paulista e niteroiense, de quem é daqui.
- O texto tem número, valor em real, telefone, data e sigla: o Lero lê do jeito que a gente fala.
- Você quer pagar em real e gastar menos: os planos mensais do Lero custam cerca de metade.
- Se você precisa de muitos idiomas no mesmo projeto, de dublagem ou de música, a ElevenLabs continua sendo a opção: dá para usar as duas.

## Conceitos

| ElevenLabs | Lero |
|---|---|
| `POST /v1/text-to-speech/{voice_id}` | `POST /v1/tts` |
| `https://api.elevenlabs.io` | `https://app.lero.studio/api` |
| Header `xi-api-key` | Header `Authorization: Bearer lero_...` |
| `voice_id` na URL | `voz` no corpo: `rio`, `sp` ou `niteroi` |
| `text` | `texto` |
| `model_id` | `model`, opcional: `Lero v1` |
| `GET /v1/voices` | `GET /v1/voices` |
| `GET /v1/user/subscription` | `GET /v1/balance` |
| Créditos por caractere | 1 crédito por caractere |
| MCP oficial (`elevenlabs-mcp`) | MCP do Lero (`npx`) |

## Gerar fala pela API

Antes, na ElevenLabs:

```bash
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/$VOICE_ID" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Seu pedido chega amanhã.", "model_id": "eleven_multilingual_v2"}' \
  --output fala.mp3
```

Depois, no Lero:

```bash
curl -X POST "https://app.lero.studio/api/v1/tts" \
  -H "Authorization: Bearer $LERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texto": "Seu pedido chega amanhã.", "voz": "rio"}' \
  --output fala.mp3
```

A resposta é o MP3 (`audio/mpeg`), como na ElevenLabs. Com `Accept: application/json`, o áudio vem em base64 no campo `audio`. Os headers `X-Creditos-Custo`, `X-Creditos-Restantes` e `X-Duracao` trazem o custo, o saldo e a duração.

## Vozes

Troque cada `voice_id` por uma das vozes do Lero:

- `rio`: sotaque carioca.
- `sp`: sotaque paulista.
- `niteroi`: sotaque niteroiense.

Para escolher, gere a mesma frase nas três e ouça com o seu texto real. A lista atualizada sai em `GET /v1/voices`.

## Limites

- Até 500 caracteres por pedido. Para texto longo, divida nas frases, gere cada parte e junte os MP3 na ordem.
- A rota `/fala` devolve o MP3 inteiro, sem streaming.
- Em `429` (`muitos_pedidos` ou `ocupado`), respeite o `Retry-After`. Em `503 carregando`, tente de novo em alguns segundos.
- A API está nos planos Creator e Dev.

## MCP

Se você gera áudio pelo Claude Code, Codex ou Cursor com o MCP da ElevenLabs, troque pelo MCP do Lero:

```bash
claude mcp add --env LERO_API_KEY=$LERO_API_KEY lero -- npx -y lero-mcp
```

```bash
codex mcp add lero --env LERO_API_KEY=$LERO_API_KEY -- npx -y lero-mcp
```

As ferramentas são `lero_fala`, `lero_vozes` e `lero_saldo`. O MP3 sai em `~/Downloads/Lero`.

## Agentes de voz

Os agentes de conversa da ElevenLabs têm equivalente no Conversational Agent do Lero, em beta: `GET /v1/agents` para o discovery e `POST /v1/agents/conversation` para abrir a conversa por WebRTC, com o seu system prompt e o seu conhecimento. Passo a passo em [lero.studio/docs](/docs#agente-guia).

## Preço

| Plano | Lero | ElevenLabs |
|---|---|---|
| Entrada | Starter: R$ 19 por mês (R$ 9 no 1º mês), 40 min | Starter: US$ 6 por mês, cerca de R$ 34, 30 min |
| Criador | Creator: R$ 49 por mês (R$ 24 no 1º mês) | Creator: US$ 22 por mês, cerca de R$ 123 |

Preços da ElevenLabs consultados em 2026-11-10 em elevenlabs.io/pricing, com câmbio de referência US$ 1 = R$ 5,42 + IOF de 3,5%. Os planos mudam: confira antes de decidir. Os preços do Lero estão em [lero.studio/precos.md](/precos.md).

## Checklist

1. Crie a conta em app.lero.studio e uma chave em Desenvolvedores.
2. Guarde a chave como `LERO_API_KEY`.
3. Troque a URL, o header e os campos (`text` → `texto`, `voice_id` → `voz`).
4. Divida os textos acima de 500 caracteres.
5. Gere a mesma frase nas três vozes e escolha.
6. Troque o MCP, se usar.