API Connection Problems

If AI translation isn’t working, this page helps you diagnose provider/API issues.

Common causes

• Missing or invalid API key
• No internet connection
• Provider rate limits or quota limits
• Wrong model selected

Quick checks

1. Verify your API key in Setting Up API Keys
2. Confirm you selected a provider and model in Settings (LLM/AI settings)
3. Try translating a single short segment (Ctrl+T)
4. Check whether your account has credits/quota

Common errors and fixes

Symptom / message	Likely cause	What to do
“Invalid API key” / authentication failed	Key is wrong or has extra whitespace	Re-paste the key; make sure there are no leading/trailing spaces; Save and restart if needed
“Rate limit exceeded”	Provider is throttling requests	Wait 1–2 minutes; reduce batch size; try a different model
“Quota/credits exceeded”	Account has no credits or billing disabled	Check provider dashboard; add credits/enable billing
“Model not found”	Selected model name not available	Pick a supported model in Settings; update if the provider changed model names
“No response” / empty translation	Transient provider failure, network issue, or timeout	Try single-segment translation; retry the segment; try a different model/provider
Connection errors / timeouts	Network/VPN/firewall/proxy issues	Try another network; disable VPN; allow Python/Supervertaler through firewall

Tips for reliable translation

• Start with single-segment translation to verify your setup before running batch.
• If batch translation returns empty segments, enable the retry option in the batch dialog.
• If your segments contain tags/placeholders, add a prompt rule to preserve them exactly.

Error messages

If you see an error dialog, copy the message and include it when asking for help.

Include:

• Provider + model
• Whether single-segment translation works
• The exact error text