BYOK: Traga a Sua Própria Chave

Mais uma subscrição? Não.

Vamos esclarecer isto desde já, porque provavelmente já está a pensar nisso.

Tem uma subscrição do Chess.com. Talvez uma doação de Patron no Lichess. Spotify. Netflix. iCloud. Talvez um jornal ou dois. O seu gestor de palavras-passe. Armazenamento na cloud. Aquela aplicação que se esqueceu de cancelar há três meses. Hoje em dia, todos os programas querem 8-15€/mês, e cada um parece pouco até os somar todos e perceber que está a gastar 200€/mês em subscrições que mal utiliza.

Nós compreendemos. Também o sentimos.

O En Parlant~ é software livre. GPL-3.0, código aberto, sem necessidade de conta, sem período de teste, sem “atualize para o Pro.” A aplicação principal — análise com motor, bases de dados de partidas, puzzles, editor de tabuleiro, tudo — não custa nada.

Mas algumas funcionalidades precisam genuinamente de serviços cloud para funcionar. A narração vocal realista necessita de uma API de síntese de voz. Esses serviços custam dinheiro a operar, e alguém tem de os pagar.

A resposta tradicional é: nós pagamos e passamos o custo para si sob a forma de subscrição. A resposta BYOK é diferente: você paga diretamente ao fornecedor cloud, às tarifas dele, por exatamente o que utiliza. Sem margem de intermediário. Sem mínimo mensal. Sem qualquer relação de faturação connosco.

É isso que esta página explica.

O Que É BYOK?

BYOK — Bring Your Own Key (Traga a Sua Própria Chave) — significa que se liga diretamente a um serviço cloud usando a sua própria conta e chave de API, em vez de passar por nós como intermediários. O En Parlant~ utiliza BYOK nas suas funcionalidades alimentadas pela cloud:

Narração por texto-para-voz — A sua chave de ElevenLabs ou Google Cloud TTS

Os seus pedidos vão diretamente do seu computador para o fornecedor. Nós nunca vemos a sua chave, nunca tocamos no seu tráfego e nunca lhe cobramos nada.

Paga diretamente ao fornecedor pelo que utiliza. Nós fornecemos o software.

Como Chegámos Aqui

O padrão BYOK não surgiu de uma única decisão. Evoluiu à medida que a indústria foi descobrindo como integrar serviços cloud poderosos em ferramentas sem criar modelos de negócio insustentáveis.

Fase 1: A Era do Alojamento (2022-2023)

Quando as APIs cloud para síntese de voz, tradução e IA começaram a tornar-se comuns, todas as aplicações que queriam estas funcionalidades tinham a mesma arquitetura: o programador regista-se numa conta de API, paga por pedido e faz proxy de tudo em nome dos utilizadores. O programador ou absorve o custo, ou passa-o através de uma subscrição, ou limita o uso com quotas.

Isto funcionava para empresas com receitas. Foi um desastre para projetos de código aberto e programadores independentes. Uma ferramenta gratuita popular podia acumular milhares de euros em faturas de API de um dia para o outro. Alguns projetos desativaram funcionalidades, outros adicionaram listas de espera, outros esgotaram as suas poupanças.

Fase 2: O Proxy por Subscrição (2023-2024)

A geração seguinte tentou um compromisso: o programador mantém um servidor proxy, os utilizadores pagam uma subscrição mensal, e a subscrição cobre os custos de API mais uma margem.

Funciona, mas transforma cada programador de aplicações num fornecedor de faturação. É preciso processamento de pagamentos, gestão de subscrições, medição de consumo, apoio ao cliente para disputas de faturação e margem suficiente para absorver picos de utilização sem ir à falência. Para uma startup apoiada por capital de risco, isso é rotina. Para um maintainer de código aberto, é um segundo emprego.

Fase 3: BYOK (2024-presente)

A constatação foi simples: se os utilizadores podem criar as suas próprias contas de API e as APIs são estáveis e bem documentadas, por que razão é que o programador está no meio?

O BYOK remove o intermediário. A aplicação armazena a sua chave localmente, chama a API diretamente, e o fornecedor trata da faturação, dos limites de taxa e da autenticação. O programador distribui software. O utilizador controla os seus próprios gastos.

No final de 2025, o BYOK tinha-se tornado a abordagem padrão para ferramentas com funcionalidades alimentadas pela cloud:

A JetBrains adicionou BYOK a todos os seus IDEs (IntelliJ, PyCharm, WebStorm, etc.) em dezembro de 2025, suportando Anthropic, OpenAI e fornecedores compatíveis.
O GitHub Copilot lançou BYOK empresarial em pré-visualização pública em novembro de 2025.
O Cursor, o editor de código com IA, oferece BYOK juntamente com o seu próprio tier alojado.
O Continue.dev, um assistente de programação com IA de código aberto, foi concebido com BYOK desde o início.
O Warp, o terminal com IA, utiliza BYOK como funcionalidade central.
O OpenHands, um agente de programação de código aberto, oferece um tier BYOK gratuito a todos os utilizadores.

O padrão funciona porque o público destas ferramentas — programadores, utilizadores avançados, pessoas que configuram os seus próprios ambientes — está confortável a gerir contas de API. Já têm chaves AWS, tokens GitHub e certificados SSH. Mais uma chave de API não é uma barreira.

Porque É Que o BYOK Se Adequa ao En Parlant~

O En Parlant~ é construído sobre BYOK desde a base. Todas as funcionalidades cloud seguem o mesmo padrão:

Funcionalidade	Opções de Fornecedor	O Que a Sua Chave Lhe Oferece
Narração vocal	ElevenLabs, Google Cloud TTS	Narração falada natural e expressiva de jogadas e comentários

Cada chave fica no mesmo sítio (definições da aplicação), funciona da mesma forma (colar e usar) e segue o mesmo princípio: a sua chave, a sua conta, o seu controlo.

Para o projeto, o BYOK significa:

Zero custos de infraestrutura. Sem servidores para manter, sem faturação para gerir.
Sem risco financeiro. Um aumento de popularidade não se torna num aumento de faturas.
Sem dores de cabeça com limites de taxa. Cada utilizador tem a sua própria quota com o seu fornecedor.
O projeto pode permanecer totalmente de código aberto e gratuito sem subsidiar o uso de APIs.
Podemos adicionar novas funcionalidades cloud sem nunca nos tornarmos num fornecedor de faturação.

Para os utilizadores, o BYOK significa:

Escolhe o seu fornecedor. TTS premium do ElevenLabs ou WaveNet gratuito do Google. Combine à vontade.
Controla os seus gastos. Veja os seus custos, pare a qualquer momento.
Os seus dados vão diretamente para o fornecedor que escolheu — não passam por um proxy de terceiros.
Sem subscrição do En Parlant~. O software é gratuito. Só paga pelos serviços cloud que decide ativar.

O que o BYOK custa na prática:

Funcionalidade	Fornecedor	Custo Mensal Típico
Narração TTS (uso casual)	Google Cloud TTS (WaveNet)	0,00 € (1M caracteres/mês no tier gratuito)
Narração TTS (uso intensivo)	ElevenLabs	~5,00 € (plano starter)
Narração TTS	Local (KittenTTS ou System TTS)	0,00 €

Para comparação, o Chess.com Diamond custa 13-20 €/mês e o DecodeChess custa 8,25 €/mês. Um utilizador típico do En Parlant~ que use o Google Cloud TTS no tier gratuito não paga absolutamente nada.

Para Utilizadores Técnicos

Já sabe como isto funciona. Aqui fica a versão rápida:

Crie uma conta no fornecedor da sua preferência.
Gere uma chave de API.
Cole-a no campo correspondente nas definições do En Parlant~.
Pronto.

Fornecedores BYOK atuais:

Serviço	Fornecedor	Onde obter uma chave
TTS	ElevenLabs	Dashboard → Profile → API Keys
TTS	Google Cloud	APIs & Services → Credentials

As suas chaves são armazenadas localmente no seu computador, no localStorage da aplicação. Nunca são transmitidas para lado nenhum exceto diretamente para o respetivo fornecedor de API nos cabeçalhos dos pedidos via HTTPS. O En Parlant~ não tem telemetria, não tem analytics e não tem componente do lado do servidor.

Se quiser funcionar totalmente offline, a configuração recomendada é o KittenTTS para narração. Funciona localmente e produz voz com som natural que está muito à frente das vozes integradas do seu sistema operativo. Sem necessidade de chave de API, sem necessidade de internet. Consulte a Visão Geral dos Fornecedores TTS para todas as opções.

Controlos de custos integrados na aplicação:

Cache de áudio (o TTS não regenera áudio para texto que já foi lido)
Cancelamento de pedidos quando navega para outra página antes de uma resposta ser concluída

Para Utilizadores Não-Técnicos

Se termos como “chave de API” não fazem parte do seu vocabulário, eis o que precisa de saber:

O conceito é simples. Serviços cloud como o ElevenLabs (para narração vocal realista) oferecem contas onde paga pelo que utiliza — como um plano de telemóvel pré-pago. Coloca dinheiro na sua conta e, cada vez que o En Parlant~ narra uma jogada, custa uma quantia mínima. O En Parlant~ liga-se à sua conta usando um código semelhante a uma palavra-passe chamado chave de API.

Não precisa de nenhuma chave. A aplicação de xadrez principal funciona totalmente sem quaisquer chaves. A narração TTS com a voz integrada do seu sistema ou o KittenTTS não requer conta nem internet. Os fornecedores cloud são um upgrade, não um requisito.

Demora cerca de cinco minutos. Cria uma conta no site do fornecedor, adiciona um método de pagamento e copia um código para as definições do En Parlant~. É tudo. Cada fornecedor tem guias passo a passo que o acompanham ao longo do processo. Incluímos ligações para esses guias diretamente na página de definições da aplicação — não ficará às escuras.

É económico. O texto-para-voz do Google Cloud tem um tier gratuito generoso que cobre a maioria dos utilizadores a custo zero. Mesmo o plano starter do ElevenLabs custa apenas 5 €/mês. Muito menos do que qualquer subscrição de xadrez.

Está sempre no controlo. Pode desativar qualquer funcionalidade a qualquer momento. E como não existe subscrição do En Parlant~ em si, não há nada para cancelar se deixar de o utilizar.

Em Resumo

O BYOK não é uma solução alternativa nem uma limitação — é uma escolha arquitetural deliberada partilhada pela JetBrains, pelo GitHub e pela maior parte do ecossistema de IA de código aberto. Mantém o software gratuito, mantém o maintainer financeiramente viável e dá aos utilizadores controlo direto sobre os seus gastos e os seus dados.

Para o En Parlant~, isto significa que podemos oferecer narração vocal premium integrada numa aplicação de xadrez gratuita e de código aberto, com o utilizador a pagar apenas pelos serviços cloud que decide utilizar. Ou nada de todo, se preferir as alternativas locais gratuitas.