Set up an API key

Why you need your own API key, how to get one and how to enter it in Qala.

Why do I need my own API key?

Qala sends translations directly from your laptop to the AI β€” not via our server. That gives you three wins: privacy (your content only goes to the provider you chose), cost control (pay-as-you-go, we don't earn anything) and independence (if our server is down, your service still runs).

πŸ’‘ Our recommendation: Cloud API instead of local model

We strongly recommend the cloud API option β€” especially Google Gemini:

  • Speed: The API delivers a translation including audio playback in 2–3 seconds. Local models (Ollama) take 7–15 seconds on the same laptop β€” too slow for a live sermon.
  • Free: A free Gemini API key easily covers a 2-hour service (1,000 requests per day).
  • Quality: Cloud models translate Tagalog, Vietnamese, Arabic and similar languages significantly better than small local models.

Local models only make sense if the laptop is very powerful (e.g. M3/M4 Pro/Max) or no internet is available in the room.

Gemini is Google's AI model. Very cheap, often completely free at moderate usage, with excellent translation quality.

Open Google AI Studio

Open aistudio.google.com/apikey and sign in with a Google account (your normal Gmail account works fine).

[Screenshot: api-gemini-step1.png] siehe images.md fΓΌr Inhalt

Click "Create API Key"

Click the blue button. You can either create a new project or pick an existing one.

[Screenshot: api-gemini-step2.png] siehe images.md fΓΌr Inhalt

Copy the key

You'll get a long code like "AIzaSyD...". Click the copy icon. Important: this key is like a password β€” never share it.

[Screenshot: api-gemini-step3.png] siehe images.md fΓΌr Inhalt

Enter it in Qala

Open Qala β†’ Admin β†’ Settings β†’ AI provider: Gemini β†’ paste the API key β†’ Save. Done.

[Screenshot: api-gemini-step4.png] siehe images.md fΓΌr Inhalt

Claude from Anthropic delivers outstanding translation quality, especially for nuanced preaching.

Open the Anthropic Console

Open console.anthropic.com/settings/keys and create an account.

[Screenshot: api-claude-step1.png] siehe images.md fΓΌr Inhalt

Add credit

Claude has no free tier β€” top up $5 or $10 of credit. That usually lasts for many months.

[Screenshot: api-claude-step2.png] siehe images.md fΓΌr Inhalt

Create an API key

Click "Create Key", give it a name (e. g. "Qala"), copy the key.

[Screenshot: api-claude-step3.png] siehe images.md fΓΌr Inhalt

Enter it in Qala

Qala β†’ Admin β†’ Settings β†’ AI provider: Claude β†’ paste the API key β†’ Save.

[Screenshot: api-claude-step4.png] siehe images.md fΓΌr Inhalt

OpenAI offers GPT-4o and GPT-4o-mini. Mature, broad language coverage, good quality.

Open the OpenAI Platform

Open platform.openai.com/api-keys and create an account.

[Screenshot: api-openai-step1.png] siehe images.md fΓΌr Inhalt

Add credit

Minimum top-up is $5. That's enough for many months.

[Screenshot: api-openai-step2.png] siehe images.md fΓΌr Inhalt

Create a key

Click "Create new secret key", give it a name, copy the key.

[Screenshot: api-openai-step3.png] siehe images.md fΓΌr Inhalt

Enter it in Qala

Qala β†’ Admin β†’ Settings β†’ AI provider: OpenAI β†’ paste the API key β†’ Save.

[Screenshot: api-openai-step4.png] siehe images.md fΓΌr Inhalt

Ollama is a free open-source tool that runs AI models directly on your computer. Fully offline, zero cost, maximum privacy.

Install Ollama

Open ollama.com/download and download the installer for your operating system.

[Screenshot: api-ollama-step1.png] siehe images.md fΓΌr Inhalt

Pull a model

In your terminal, run ollama pull gemma3:4b β€” this downloads a translation model (~3 GB). Alternative: ollama pull qwen2.5:7b for higher quality.

[Screenshot: api-ollama-step2.png] siehe images.md fΓΌr Inhalt

Enable Ollama mode in Qala

Qala β†’ Admin β†’ Settings β†’ Mode: Ollama β†’ pick model β†’ Save. No API key needed.

[Screenshot: api-ollama-step3.png] siehe images.md fΓΌr Inhalt

Runs completely offline

From now on Qala needs no internet. Perfect for camps, open-air services or churches with strict privacy requirements.

[Screenshot: api-ollama-step4.png] siehe images.md fΓΌr Inhalt

What will it cost me?

A transparent overview β€” we earn nothing from API usage, you pay the provider directly.

Model 2-hour service Quality 52 services / year
Gemini 2.0 Flash ~ $0.02 Very good ~ $1
GPT-4o mini ~ $0.03 Very good ~ $1.50
Claude Haiku ~ $0.20 Excellent ~ $10
Claude Sonnet ~ $0.60 Outstanding ~ $30
Ollama (local) $0.00 Good $0.00

Prices are estimates based on current API rates (April 2026) and may vary. Many providers offer a monthly free tier that's already sufficient for smaller churches.

Got your key?

Open Qala and paste it into the setup wizard or under Admin β†’ Settings.

Back to install guide β†’