Skip to content

Provider support

Glossa supports cloud providers, local inference, DeepL for the first translation pass, and user-defined OpenAI-compatible endpoints. The supported set in the app includes:

  • Gemini
  • OpenAI
  • Anthropic
  • DeepSeek
  • DeepL API
  • Ollama
  • Custom endpoints (any OpenAI-compatible API)

Local versus cloud versus custom

Provider typeNotes
CloudBest when you need managed APIs, remote capacity, and less machine setup
DeepLDedicated stage for DeepL Hybrid mode; it is not used as an LLM model for refinement, judging, or coherence
OllamaLocal-first option for offline or private setups on your own hardware
CustomThird-party or self-hosted OpenAI-compatible endpoints (OpenRouter, Groq, LM Studio, vLLM, corporate proxies)

Custom endpoints

Via Settings → Custom you can define arbitrary endpoint profiles. Each profile has:

  • Name — a descriptive label for the profile
  • Base URL — the root of the OpenAI-compatible endpoint (e.g. https://openrouter.ai/api/v1)
  • Requires API key — toggle; when on, the key is stored in the OS keychain
  • Test connection — verifies the endpoint is reachable with a model of your choice

To save or test a profile, both its name and base URL must be complete and valid. Glossa does not keep an incomplete profile or one with an unrecognizable address.

To protect API keys, remote endpoints must use https://. http:// is accepted only for services on the local machine: localhost, 127.0.0.1, and ::1. An insecure remote profile is rejected before Glossa sends credentials or requests.

In the pipeline stage, selecting the Custom provider shows a second dropdown to choose the profile and a free-text field for the model name.

Provider selection guide

NeedPractical choice
Lowest setup frictionCloud provider with an API key
Fast first translation with controlled terminologyDeepL Hybrid with a DeepL glossary, followed by LLM refinement when needed
Local-only workflowOllama
Heavy review and reasoningLarger hosted models or a strong local model if hardware allows it
Corpus-scale consistencyStable provider/model choice across the whole project

Model selection criteria

The right model depends on the type of work and expected volume:

  • High volume, technical or repetitive text — use each provider's flash or mini models (e.g. Gemini Flash, GPT-4o Mini). They are fast, cost-effective, and accurate enough for structured content.
  • Literary refinement or stylistically dense text — prefer flagship or reasoning models (e.g. Gemini Pro, GPT-4o, Claude Sonnet/Opus). They handle tone, register, and nuance more reliably.
  • Audit stage and quality judgement — use models with strong judge capabilities (critical evaluation), typically flagship models with a long context window. A mini model in the audit stage tends to produce poorly calibrated judgements.
  • Corpus consistency — avoid changing the model mid-project if you want stylistically homogeneous output.
  • DeepL Hybrid — DeepL does not use an LLM model picker: you configure register, translation mode, DeepL glossary, then choose the LLM model separately for refinement and judging.

Operational differences

  • Cloud providers depend on API keys and network stability.
  • DeepL depends on API key status, billed character quota, and supported language pairs.
  • Ollama depends on local server availability and local hardware budget.
  • Different providers may behave differently on long contexts, formatting, and review strictness.

Practical guidance

  • Use the same provider/model combination consistently within a project when you want stable output.
  • In DeepL Hybrid, keep the refinement and judge model stable as well: DeepL covers the first draft, not the critical review.
  • If a provider is unavailable, verify the API key or local server before changing the rest of the pipeline.
  • Keep the provider choice documented in the project if the project is meant to be shared later.
  • If Ollama is slow or unstable, reduce chunk size or switch to a smaller local model before changing prompts.

Public documentation for the Glossa desktop app