# ============================================================
# API KEYS CONFIGURATION - SUPERVERTALER
# ============================================================
#
# SECURITY NOTICE:
# ---------------
# This is an EXAMPLE file only. Your actual API keys should be stored at:
#
# FOR DEVELOPERS (running from source):
#   → user_data_private/api_keys.txt (gitignored, never synced to GitHub)
#
# FOR END USERS (pip install or .exe):
#   → user_data/api_keys.txt (app auto-creates this location)
#
# SETUP INSTRUCTIONS:
# ------------------
# 1. Copy this file to the appropriate location above
# 2. Remove the # symbol before each key you want to use
# 3. Replace [YOUR_KEY_HERE] with your actual API key
# 4. Save the file
# 5. Restart Supervertaler
#
# IMPORTANT:
# ---------
# • Never share your API keys with anyone
# • Never commit api_keys.txt to version control
# • Developer keys in user_data_private/ are fully gitignored
#
# WHERE TO GET API KEYS:
# ---------------------
# OpenAI:             https://platform.openai.com/api-keys
# Anthropic (Claude): https://console.anthropic.com/settings/keys  
# Google (Gemini):    https://aistudio.google.com/app/apikey
# Google Translate:   https://console.cloud.google.com/apis/credentials
#                     (Enable "Cloud Translation API" first)
# DeepL API Pro:      https://www.deepl.com/pro-api
#
# ============================================================


# ============================================
# LLM PROVIDERS (for AI Translation & AI Assistant)
# ============================================
# These are for AI-powered translation using ChatGPT, Claude, Gemini, etc.

# OpenAI (GPT-4o, GPT-4o-mini, GPT-5, o1, o3)
# Get your key at: https://platform.openai.com/api-keys
openai = YOUR_OPENAI_KEY_HERE

# Anthropic Claude (Claude Sonnet 4.5, Haiku 4.5, Opus 4.1)
# Get your key at: https://console.anthropic.com/settings/keys
claude = YOUR_CLAUDE_KEY_HERE

# Google Gemini (Gemini 2.5 Flash, 2.5 Pro)
# Get your key at: https://aistudio.google.com/app/apikey
gemini = YOUR_GOOGLE_GEMINI_KEY_HERE

# ============================================
# LOCAL LLM (Ollama) - No API key needed!
# ============================================
# Ollama runs locally on your computer.
# Install from: https://ollama.com
# Default endpoint (change only if using non-standard port):
ollama_endpoint = http://localhost:11434

# ============================================
# MACHINE TRANSLATION APIs (for MT Preview panel)
# ============================================
# These are DIFFERENT from the LLM APIs above!
# MT APIs provide quick machine translations, not AI-powered translation.
# Supervertaler will use MT providers in this priority order (first available):
# 1. Google Translate
# 2. DeepL
# 3. Microsoft Translator
# 4. Amazon Translate
# 5. ModernMT
# 6. MyMemory (free fallback, works without key)

# Google Cloud Translation API (Priority: Highest)
# Get your key at: https://console.cloud.google.com/apis/credentials
# Enable "Cloud Translation API" first, then create API key
google_translate = YOUR_GOOGLE_CLOUD_TRANSLATE_KEY_HERE

# DeepL API Pro
# Get your key at: https://www.deepl.com/pro-api
# Note: Free DeepL web version keys don't work, you need API Pro
deepl = YOUR_DEEPL_API_PRO_KEY_HERE

# Microsoft Azure Translator
# Get your key at: https://azure.microsoft.com/en-us/services/cognitive-services/translator/
# Requires Azure subscription
microsoft_translate = YOUR_AZURE_TRANSLATOR_KEY
microsoft_translate_region = global
# (Region examples: "global", "eastus", "westus")

# Amazon Translate (AWS)
# Get your keys at: https://aws.amazon.com/translate/
# Requires AWS account
amazon_translate = YOUR_AWS_ACCESS_KEY_ID
amazon_translate_secret = YOUR_AWS_SECRET_ACCESS_KEY
amazon_translate_region = us-east-1
# (AWS region examples: "us-east-1", "eu-west-1", etc.)

# ModernMT
# Get your key at: https://www.modernmt.com/api
modernmt = YOUR_MODERNMT_API_KEY

# MyMemory Translation (Free tier available, no key required)
# Get API key (optional, for higher limits): https://mymemory.translated.net/
# Works without key but with lower rate limits
# TIP: Use your email instead of an API key to get 10,000 words/day instead of 1,000!
#      Example: mymemory = your.email@example.com
mymemory = YOUR_MYMEMORY_KEY

# NOTE: The above keys are FAKE examples for illustration only.
#       Do NOT use them - they will not work!

# TROUBLESHOOTING:
# ---------------
# If you see "API Key Missing" errors:
# 1. Check that your file is in the correct location:
#    - Developers: user_data_private/api_keys.txt
#    - End users: user_data/api_keys.txt
# 2. Make sure the # is removed from the beginning of the line
# 3. Verify there are no extra spaces around the = sign
# 4. Confirm your key is valid (test at the provider's website)
#
# If keys still don't work:
# 1. Check console output to see which file was loaded
# 2. Look for errors: "Error loading API keys"
# 3. Restart Supervertaler after editing api_keys.txt
#
# DeepL Authorization Error:
# - Your key must be for "DeepL API Pro" (not free web version)
# - Get API key from: https://www.deepl.com/pro-api
#
# Google Translate Error:
# - Enable "Cloud Translation API" in Google Cloud Console
# - Create API key at: https://console.cloud.google.com/apis/credentials

# ============================================================