OpenAI
Crie uma conta na OpenAI Platform, adicione saldo ou um método de pagamento, abra API keys e escolha Create new secret key. Copie a chave de imediato, pois não voltará a ser apresentada por inteiro.
Criar uma chave da OpenAIA sua primeira tradução
Do seu livro à tradução, passo a passo
Não precisa de saber programar. Se consegue descarregar um ficheiro, editar uma linha e copiar um comando, consegue preparar a primeira tradução.
O que é necessário
Prepare quatro coisas. Apenas a utilização do modelo de linguagem escolhido tem custos.
- Um computador com Windows, macOS ou Linux.
- O seu ficheiro EPUB, PDF ou MOBI, que deve ter o direito de tratar.
- Python 3.10 ou mais recente, gratuito.
- Uma chave API da OpenAI ou da Anthropic. Não precisa das duas.
Obtenha uma chave API
Uma chave API é uma palavra-passe privada que permite ao Berilo enviar texto diretamente ao fornecedor escolhido e cobrar a utilização na sua conta. Uma subscrição do ChatGPT ou do Claude não inclui necessariamente a API; confirme a faturação na consola do fornecedor.
Anthropic
Crie uma conta na consola do Claude, configure a faturação, abra API Keys e escolha Create Key. Esta chave também é apresentada apenas uma vez.
Criar uma chave da AnthropicNão envie a chave por e-mail, não a publique nem a cole neste site. Guarde-a apenas no ficheiro local .env descrito abaixo. Defina um limite de gastos junto do fornecedor.
Descarregue o Berilo e o Python
Descarregue o projeto Berilo em ZIP a partir do GitHub e extraia-o num local que consiga encontrar depois, como Documentos/Berilo.
Depois instale o Python 3.10 ou mais recente. No Windows, selecione Add Python to PATH no instalador.
Descarregar o Python do site oficialAdicione a chave e instale o tradutor
Encontre .env.example na pasta extraída do Berilo. Se não vir ficheiros cujo nome começa por um ponto, ative a apresentação de ficheiros ocultos.
- Faça uma cópia de .env.example e mude o nome da cópia para .env.
- Abra .env num editor de texto. Cole a chave depois de OPENAI_API_KEY= ou ANTHROPIC_API_KEY=. A outra linha pode ficar vazia.
- Abra um terminal na pasta do Berilo. No Windows, escreva powershell na barra de endereço da pasta; no macOS, abra o Terminal e arraste a pasta para a janela.
python -m pip install -e ./translatorQuando a instalação terminar, verifique a ligação. O teste traduz uma frase e tem um custo praticamente nulo.
berilo doctorVerifique o custo e traduza
Copie o livro para a pasta do Berilo ou use o caminho completo no comando. Coloque sempre entre aspas os caminhos que contêm espaços.
Primeiro, confirme que o Berilo consegue ler o livro:
berilo inspect "moja-knjiga.epub"Depois obtenha uma estimativa gratuita do custo. Faça-o sempre antes de traduzir:
berilo translate "moja-knjiga.epub" --to sl --dry-runSe a estimativa for aceitável, inicie a tradução:
berilo translate "moja-knjiga.epub" --to slO EPUB traduzido é guardado junto do original. Pode reiniciar uma tradução interrompida: o Berilo continua a partir da cache e não volta a cobrar as secções já concluídas.
Abra o livro traduzido
Pode abrir imediatamente o EPUB traduzido em qualquer leitor de EPUB. Quando o APK oficial do Berilo for publicado, descarregue-o apenas a partir de Releases: permita a instalação de aplicações desconhecidas para o navegador ou gestor de ficheiros do Android e abra o APK descarregado.
Consultar as versões oficiaisAvançado: compilar a aplicação Android a partir do código
Esta opção requer Android Studio, um JDK e adb. Destina-se a pessoas com experiência técnica e não é necessária para a primeira tradução.
cd android
./gradlew assembleReleaseadb install -r app/build/outputs/apk/release/app-release.apkUm limite justo
O Berilo ajuda a ler. Não ajuda a obter livros.
Use apenas ficheiros que possui legalmente e tem o direito de tratar. O Berilo não tem catálogo, downloads, remoção de DRM nem partilha. Assim, a ferramenta pode permanecer aberta e útil para os leitores, respeitando autores e editoras.
Voltar ao Berilo