Translation services¶

Cambiato nella versione 4.13: Prima di Weblate 4.13, i servizi erano configurati nel file Configurazione.

The support for several machine translation and translation memory services is built-in. You can install a service more than once with different settings. An administrator can configure installations for the whole site under Translation services in Management interface. Workspace administrators can configure installations for their workspace, and project administrators can configure them for a project:

Nota

They come subject to their terms of use, so ensure you are allowed to use them how you want. Third-party services can receive source strings, translations, and related context from Weblate.

I servizi traducono dalla lingua sorgente come configurato in Component configuration vedere Lingua di origine.

Installations from the site, workspace, and project are combined for a project. You can exclude an inherited installation, or all inherited installations of one service, in workspace or project settings. Pausing an installation keeps its configuration for later use.

Select a service in the listing to open its details, settings, and controls. Installed services use their numeric installation ID in the detail-page URL. The detail page provides selectors to use in Automation workflows. Inherited services link to their owning scope when you have permission to manage them. The listing summarizes basic configuration such as the model, source-language selection, and region, together with the installation ID and slug. Credentials, API URLs, and free-form prompts are excluded from these summaries.

A Rate limited badge indicates that Weblate has temporarily paused requests after a provider error. The default cooldown is 30 minutes, but its duration varies by service and provider-supplied retry delays; see cooldown configuration. It applies to one installation, including all projects inheriting it. Separate installations have independent cooldowns, even when they use the same provider credentials.

Administrators can use Reset rate limit on the installation’s detail page at its owning site, workspace, or project scope. This clears Weblate’s translation and rephrasing cooldowns without clearing cached suggestions. It does not reset the provider’s quota; another provider error can apply the cooldown again. Inherited installations show the status, but their cooldown cannot be reset from a consuming workspace or project.

The Logs tab on an installation’s detail page lists errors from fetching supported languages, translations, and rephrased suggestions, including provider rate limits. Logs belong to the installation, including when it is used by inheriting projects. Only administrators who can manage the installation at its owning scope can read its logs. Inherited services link to these logs when you have the required permission.

Messages retain provider diagnostics with URLs and configured secrets redacted. Providers can echo translation content in their messages, so logs can still contain source strings or translations. Errors are kept for 30 days by default; configure MACHINERY_ERROR_KEEP_DAYS to change retention. Old entries are removed daily. Removing an installation also removes its logs.

Every installation has a numeric ID and can have an optional slug. Select one installation in automatic translation, Automation, or AI review with service:id or service:slug. A bare service name is accepted when only one active installation of that service applies to the project. A non-empty slug must be unique among all installations visible to a project, including inherited installations. Separate projects can use the same slug. Saved slug selectors follow the installation currently using that slug. Services without configuration settings can be installed once per scope and must not overlap with enabled inherited installations. Exclude an inherited installation before enabling another one in a lower scope. Each scope can contain up to 20 installations, including paused ones.

For install_machinery --update, specify a unique --slug or --id when more than one site installation of a service exists.

Translation service installations can also be configured via the API REST di Weblate.

Configured translation services provide suggestions in the Automatic suggestions tab of the translation editor and can be selected for Traduzione automatica.

Vedi anche

Suggerimenti automatici

Priorità ai servizi di traduzione automatica e di memorie di traduzione¶

Weblate Translation Memory matches with 100% score take priority over machine translation services. If 100% match in translation memory is found, no machine translation is performed. If several 100% matches occur, the first one returned by the database is used.

Each machine translation service has a predefined maximum score it can produce. The use of installed translation services is ordered according to their maximum score. For each string with translation score lower than the service’s maximum, the service is asked to produce a translation. Translations with a score exceeding the current one are accepted.

For explicit ordering and a separate score threshold for each service, use Apply translation memory before machine translation. This workflow completes one translation pass before selecting the strings for the next service.

Stringhe di origine per la traduzione automatica¶

Added in version 5.11.

The origin of source strings for all third-party services can be configured. This can be used to tweak the service to get the best results. Following choices are available:

Selezione automatica

Chooses the best source language automatically.

Questo è il comportamento predefinito.

Lingua sorgente del componente

Utilizza la lingua sorgente dei componenti.

This was the behavior before the 5.11 release.

Lingua secondaria definita nel progetto o nel componente

Usa progetto Lingua secondaria o componente Lingua secondaria.

Falls back to the automatic selection of the source language if the secondary language not configured.

LLM translation context¶

LLM-based translation services receive additional context about each translated string, when available. This includes the string context or monolingual key, additional explanation, configured secondary-language translation, plural information, failing quality checks, and placeholder contents. Matching glossary entries are passed with their explanations and selected flags, so duplicate glossary terms can be disambiguated.

You can add target-language-specific instructions in Language-specific instructions using a JSON object mapping language codes to text. Language codes have to exist in Weblate and are matched exactly; whitespace is not ignored. Each instruction can contain up to 1000 characters. Weblate first looks for the exact target language code and then falls back to the base language code.

The added metadata is used only to guide the generated suggestion; the returned translation still has to preserve the source placeholders and markup. Weblate also sends a short previous chat exchange to LLM services to demonstrate the expected JSON response format. The exchange uses bundled translated examples when available for the source and target language pair, or language-neutral formatting examples otherwise. Existing translations for the same target language can be appended as additional examples.

Alibaba¶

Added in version 5.3.

ID servizio:

alibaba

Maximum score:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`key`	ID chiave accesso
`secret`	Accesso alla chiave segreta
`region`	ID regione

Alibaba Translate is a neural machine translation service for translating text and it supports up to 214 language pairs.

Vedi anche

Alibaba Translate Documentation

Anthropic¶

Added in version 5.16.

ID servizio:

anthropic

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`base_url`	URL API di Anthropic	URL di base dell’API Anthropic. Lascia vuoto per utilizzare l’URL predefinito.
`model`	Modello di Anthropic	Scelte disponibili: `claude-haiku-4-5` – Claude Haiku 4.5 `claude-sonnet-5` – Claude Sonnet 5 `claude-opus-5` – Claude Opus 5 `claude-fable-5-1` – Claude Fable 5.1 `claude-opus-4-8` – Claude Opus 4.8 `claude-fable-5` – Claude Fable 5 `custom` – Modello personalizzato
`persona`	Profilo traduttore	Describe the translator’s role or expertise. For example: “You are an experienced medical translator.”
`style`	Translation style	Describe the desired translation style. For example: “Use informal language.”
`language_instructions`	Istruzioni specifiche per lingua	Enter a JSON object mapping target language codes recognized by Weblate to additional translation instructions. Each instruction can contain up to 1000 characters. For example: {«de»: «Use formal address.»}
`key`	Chiave API
`custom_model`	Nome del modello personalizzato	Required when ‘Custom model’ is selected. Enter the model identifier used by the API.
`max_tokens`	Numero massimo di token	Maximum number of tokens in the generated response.

Esegue la traduzione utilizzando i modelli Anthropic’s Claude.

The Anthropic API provides access to the Claude family of models, which are known for their strong reasoning and language capabilities. You need an API key from Anthropic to use this service.

The model choices favor current generally available Claude models. Previously offered models remain selectable while Anthropic continues to support them.

Use persona and style fields to further fine-tune translations. These will be used in a prompt for Claude and allow you to change the style of the translations.

The service automatically uses Glossario, see Glossaries in translation services.

Vedi anche

Apertium APy¶

ID servizio:

apertium-apy

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

url

URL API

A libre software machine translation platform providing translations to a limited set of languages.

The recommended way to use Apertium is to run your own Apertium-APy server.

Vedi anche

Amazon Translate¶

ID servizio:

aws

Maximum score:

Funzionalità avanzate:

Glossaries in translation services

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`key`	ID chiave accesso
`secret`	Chiave segreta API
`region`	Nome regione
`formality`	Formalità	Scelte disponibili: empty value – Default `FORMAL` – Formal `INFORMAL` – Informal
`brevity`	Brevity	Preferisci traduzioni più brevi, ove possibile. Scelte disponibili: empty value – Default `ON` – Enabled
`profanity`	Volgarità	Maschera le parole volgari nel testo tradotto. Scelte disponibili: empty value – Default `MASK` – Mask profanity

Amazon Translate is a neural machine translation service for translating text to and from English across a breadth of supported languages. The service requires the TranslateFullAccess Managed Policy.

The service automatically uses Glossario, see Glossaries in translation services.

Vedi anche

Azure OpenAI¶

Added in version 5.8.

ID servizio:

azure-openai

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`base_url`	URL API
`model`	Modello LLM
`persona`	Profilo traduttore	Describe the translator’s role or expertise. For example: “You are an experienced medical translator.”
`style`	Translation style	Describe the desired translation style. For example: “Use informal language.”
`language_instructions`	Istruzioni specifiche per lingua	Enter a JSON object mapping target language codes recognized by Weblate to additional translation instructions. Each instruction can contain up to 1000 characters. For example: {«de»: «Use formal address.»}
`key`	Chiave API
`azure_endpoint`	URL endpoint Azure OpenAI	URL dell’endpoint dell’istanza, ad esempio: https://my-instance.openai.azure.com.
`deployment`	Distribuzione di Azure OpenAI	Nome di distribuzione univoco del modello.

Esegue la traduzione utilizzando OpenAI ospitato su Azure.

Vedi anche

OpenAI

Baidu¶

ID servizio:

baidu

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

ID client

secret

Segreto client

Machine translation service provided by Baidu.

This service uses an API and you need to obtain an ID and API key from Baidu to use it.

Vedi anche

Baidu Translate API

CyrTranslit¶

Added in version 5.7.

ID servizio:

cyrtranslit

Maximum score:

100

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

Servizio di traduzione automatica con la libreria Cyrtranslit.

This service converts text between Cyrillic and Latin scripts for languages that have both scripts.

Vedi anche

Cyrtranslit repository

DeepL¶

ID servizio:

deepl

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`url`	URL API
`key`	Chiave API
`formality`	Formalità	Se la lingua non è specificata come (in)formale usa la formalità specificata
`context`	Contesto di traduzione	Descrivi il contesto della traduzione per migliorare la precisione della traduzione.
`next_gen`	Usa il modello di nuova generazione	Preferisci l’LLM di nuova generazione al modello classico di traduzione automatica.

DeepL is a paid service providing good machine translation for a few languages. You need to purchase DeepL API subscription.

API URL to use with the DeepL service. Configure the base endpoint without an API version; Weblate selects the appropriate DeepL API version for each request. For a legacy subscription requiring API v1, configure https://api.deepl.com/v1/ instead.

Cambiato nella versione 2026.9.1: Support for explicitly configured DeepL API v1 endpoints has been restored.

https://api.deepl.com/ (default in Weblate): Is meant for API usage on the paid plan, and the subscription is usage-based.
https://api-free.deepl.com/: Is meant for API usage on the free plan, and the subscription is usage-based.

Weblate supports DeepL formality, it will choose matching one based on the language (for example, there is de@formal and de@informal).

The translation context can optionally be specified to improve translations quality. Read more on that in DeepL translation context documentation.

The service automatically uses Glossario, see Glossaries in translation services. Glossary integration is not available with API v1.

Rephrasing existing translations¶

When a string is already translated, Weblate can send the stored target text to the DeepL Write API /v2/write/rephrase endpoint and show the improved text as an additional machine translation suggestion.

This requires a DeepL API Pro subscription using https://api.deepl.com/. Rephrasing is skipped when using the free API endpoint.

Only languages supported by the DeepL Write API are eligible. The stored translation is sent as plain text, without the XML placeholder handling used for DeepL translation. Rephrase suggestions use a slightly lower score than DeepL translations so automatic translation keeps preferring the translate result. Successful rephrases are cached; this still performs an extra API request on cache miss and may increase API usage and billing.

Vedi anche

eTranslation¶

ID servizio:

etranslation

Maximum score:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`key`	Application name
`secret`	Password
`domain`	Default language domain	Scelte disponibili: `GEN` – General Text (GEN) `SPD` – EU Formal Language (SPD) `ECB` – Finance (ECB) `ECJ` – European Court of Justice (ECJ) `IPO` – EIP Case Law (Intellectual Property) (IPO) `_OTHER` – Other domain code
`other_domain`	Other domain code	Enter a domain code from eTranslation when selecting Other domain code.
`component_domains`	Component language domains	JSON object mapping full component paths to domain codes, for example {«my-project/privacy-policy»: «SPD»}.

Register an application with the European Commission to obtain its application name and password, then configure eTranslation in Automatic suggestions. The credentials are sent with HTTP Basic authentication. The default language domain is GEN (General Text). Select one of the documented domains by name, or select Other domain code to enter a code returned by eTranslation. The service’s domains endpoint supplies available domain codes and their supported language pairs. The API also lists QE (Quality Estimation) and NER, but their use as translation domains is not described in the domain documentation.

Use Component language domains to select a different domain for individual components. Enter a JSON object whose keys are full component paths, including category segments where applicable. Use the domain codes shown in parentheses in the Default language domain choices:

{"my-project/privacy-policy": "SPD"}

Components absent from the mapping use Default language domain. The mapping belongs to the eTranslation service configuration, not to component settings. Project-level service configuration overrides the site-wide service configuration as it does for other suggestion services. Suggestions show the domain used for each translation.

eTranslation returns text through an asynchronous callback. Set SITE_DOMAIN to the publicly reachable domain and enable HTTPS so the callback URL is accessible from eTranslation. All Weblate application processes must share the configured cache. Weblate waits up to 15 seconds for each text suggestion; a later callback cannot populate that suggestion. Text snippets longer than 5,000 characters are skipped.

Vedi anche

Glosbe¶

ID servizio:

glosbe

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

Free dictionary and translation memory for almost every living language.

The API is gratis to use, but usage of the translations is subject to the license of the used data source. There is a limit of calls that may be done from one IP in a set period of time, to prevent abuse.

Vedi anche

Glosbe website

Google Cloud Translation Basic¶

ID servizio:

google-translate

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

Chiave API

Traduzione automatica fornito dai servizi Google Cloud.

This service uses the Google Translation API v2, and you need to obtain an API key and turn on billing in the Google API console.

Vedi anche

Google translate documentation

Google Cloud Translation Advanced¶

ID servizio:

google-translate-api-v3

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`credentials`	Informazioni account servizio Google Translate	Inserisci una chiave JSON per l’account di servizio.
`project`	Progetto Google Translate	Inserisci l’ID numerico/alfanumerico del progetto Google Cloud.
`location`	Posizione Google Translate	Scegli una regione Google Cloud Translation da usare per il progetto Google Cloud o la regione più vicina a te.
`bucket_name`	Nome bucket di Google Storage	Inserisci il nome del bucket Google Cloud Storage usato per archiviare i file del glossario.

Traduzione automatica fornito dai servizi Google Cloud.

This service uses the Google Translation API v3 and you need credentials in JSON format to access it.

In order to use this service, you first need to go through the following steps:

Optionally, you can configure the service to use Glossario by setting up a Bucket:

Vedi anche

Traduttore linguistico IBM Watson¶

Removed in version 5.13.1: This service was withdrawn by vendor as of 10 December 2024.

LibreTranslate¶

Added in version 4.7.1.

ID servizio:

libretranslate

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

url

URL API

key

Chiave API

LibreTranslate is a free and open-source service for machine translations. The public instance requires an API key, but LibreTranslate can be self-hosted and there are several mirrors available to use the API for free.

https://libretranslate.com/ (official public instance): Requires an API key to use outside of the website.

Vedi anche

LTEngine¶

Added in version 5.17.1.

ID servizio:

ltengine

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

url

URL API

key

Chiave API

LTEngine provides a local LibreTranslate-compatible API backed by large language models. For many Weblate installations, native LLM services such as Ollama can be a better fit because Weblate can send translation context directly to the model. Use LTEngine when you specifically want its local translation engine or future LTEngine translation improvements.

Azure AI Translator¶

ID servizio:

microsoft-translator

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`key`	Chiave API
`base_url`	URL base applicazione	Scelte disponibili: `api.cognitive.microsofttranslator.com` – Global (non-regional) `api-apc.cognitive.microsofttranslator.com` – Asia Pacific `api-eur.cognitive.microsofttranslator.com` – Europe `api-nam.cognitive.microsofttranslator.com` – North America `api.translator.azure.cn` – China `api.cognitive.microsofttranslator.us` – Azure US Government cloud
`endpoint_url`	URL server autenticazione	Può essere specificato «Regionale» o «Multiservizio» usando il campo regione sottostante. Scelte disponibili: `api.cognitive.microsoft.com` – Global `api.cognitive.azure.cn` – China `api.cognitive.microsoft.us` – Azure US Government cloud
`region`	Regione servizio autenticazione
`category`	Categoria	Specifica un ID di categoria di sistema personalizzato da usare al posto di quello generale.

Machine translation service provided by Microsoft in Azure portal as one of Cognitive Services.

Weblate implements Translator API V3.

The service automatically uses Glossario via dynamic dictionary, see Glossaries in translation services.

Translator Text API V2¶

The key you use with Translator API V2 can be used with API 3.

Translator Text API V3¶

You need to register at Azure portal and use the key you obtain there. With new Azure keys, you also need to set region to locale of your service.

You can also specify a custom category to use custom translator.

Suggerimento

For Azure China, please use your endpoint from the Azure Portal.

Vedi anche

Mistral¶

Added in version 2026.7.

ID servizio:

mistral

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`base_url`	URL di base API Mistral	URL di base dell’API Mistral, se diverso dall’URL predefinito di Mistral
`model`	Modello Mistral	With ‘Automatic selection’, Weblate selects the first model available through the API from its predefined preference list. Scelte disponibili: `auto` – Selezione automatica `mistral-small-latest` – Mistral Small 4 `ministral-14b-latest` – Ministral 3 14B `ministral-8b-latest` – Ministral 3 8B `ministral-3b-latest` – Ministral 3 3B `mistral-large-latest` – Mistral Large 3 `mistral-medium-latest` – Mistral Medium 3.5 `custom` – Modello personalizzato
`persona`	Profilo traduttore	Describe the translator’s role or expertise. For example: “You are an experienced medical translator.”
`style`	Translation style	Describe the desired translation style. For example: “Use informal language.”
`language_instructions`	Istruzioni specifiche per lingua	Enter a JSON object mapping target language codes recognized by Weblate to additional translation instructions. Each instruction can contain up to 1000 characters. For example: {«de»: «Use formal address.»}
`key`	Chiave API
`custom_model`	Nome del modello personalizzato	Required when ‘Custom model’ is selected. Enter the model identifier used by the API.

Automatic and predefined model selection queries the service model-listing endpoint. Automatic selection prefers general-purpose models that balance translation quality, response time, and price, trying other available models in the displayed order. Choose Custom model when using a compatible gateway that does not provide model discovery; Weblate sends the configured model identifier directly to the chat endpoint.

ModernMT¶

Added in version 4.2.

ID servizio:

modernmt

Maximum score:

Funzionalità avanzate:

Glossaries in translation services

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`url`	URL API
`key`	Chiave API
`context_vector`	Vettore di contesto	Elenco, separato da virgole, di identificativi di memoria seguiti dal loro peso (ID:peso). Esempio 1234:0.123,4567:0.456

The service automatically uses Glossario, see Glossaries in translation services.

Vedi anche

ModernMT API

MyMemory¶

ID servizio:

mymemory

Maximum score:

100

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`email`	E-mail contatto
`username`	Nome utente
`key`	Chiave API

Huge translation memory with machine translation.

Free, anonymous usage is currently limited to 100 requests/day, or to 1000 requests/day when you provide a contact e-mail address in email. You can also ask them for more.

Vedi anche

MyMemory website

Netease Sight¶

ID servizio:

netease-sight

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

ID client

secret

Segreto client

Traduzione automatica fornita da NetEase.

This service uses an API, and you need to obtain key and secret from NetEase.

Vedi anche

NetEase Sight Translation Platform

Ollama¶

Added in version 5.15.

ID servizio:

ollama

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`base_url`	URL API	Base URL of the Ollama API, reachable from the Weblate server. The default is http://localhost:11434; localhost refers to the environment where Weblate runs.
`model`	Modello Ollama	Nome del modello descritto nel catalogo Ollama.
`persona`	Profilo traduttore	Describe the translator’s role or expertise. For example: “You are an experienced medical translator.”
`style`	Translation style	Describe the desired translation style. For example: “Use informal language.”
`language_instructions`	Istruzioni specifiche per lingua	Enter a JSON object mapping target language codes recognized by Weblate to additional translation instructions. Each instruction can contain up to 1000 characters. For example: {«de»: «Use formal address.»}

Esegue la traduzione utilizzando i modelli Ollama.

The Ollama API allows for the use of open source models for translations either locally installed or remotely accessed via the Ollama service. Note that before configuring your models, you should have Ollama installed and downloaded the models you wish to use.

Use persona and style fields to further fine-tune translations. These will be used in a prompt for Ollama and allow you to change the style of the translations.

The service automatically uses Glossario, see Glossaries in translation services.

Vedi anche

Ollama models

OpenAI¶

Added in version 5.3.

ID servizio:

openai

Maximum score:

Funzionalità avanzate:

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`base_url`	URL di base API OpenAI	URL di base dell’API OpenAI, se diverso dall’URL predefinito di OpenAI
`model`	Modello OpenAI	With ‘Automatic selection’, Weblate selects the first model available through the API from its predefined preference list. Scelte disponibili: `auto` – Selezione automatica `gpt-5.6-luna` – GPT-5.6 Luna `gpt-5.4-mini` – GPT-5.4 mini `gpt-5-mini` – GPT-5 mini `gpt-5.4-nano` – GPT-5.4 nano `gpt-5-nano` – GPT-5 nano `gpt-5.6-terra` – GPT-5.6 Terra `gpt-5.4` – GPT-5.4 `gpt-5` – GPT-5 `gpt-5.6` – GPT-5.6 Sol `gpt-5.5` – GPT-5.5 `gpt-4.1-mini` – GPT-4.1 mini `gpt-4o-mini` – GPT-4o mini `gpt-4.1-nano` – GPT-4.1 nano `gpt-4.1` – GPT-4.1 `gpt-4o` – GPT-4o `gpt-4-turbo` – GPT-4 Turbo `gpt-4` – GPT-4 `gpt-3.5-turbo` – GPT-3.5 Turbo `custom` – Modello personalizzato
`persona`	Profilo traduttore	Describe the translator’s role or expertise. For example: “You are an experienced medical translator.”
`style`	Translation style	Describe the desired translation style. For example: “Use informal language.”
`language_instructions`	Istruzioni specifiche per lingua	Enter a JSON object mapping target language codes recognized by Weblate to additional translation instructions. Each instruction can contain up to 1000 characters. For example: {«de»: «Use formal address.»}
`key`	Chiave API
`custom_model`	Nome del modello personalizzato	Required when ‘Custom model’ is selected. Enter the model identifier used by the API.

Esegue la traduzione utilizzando OpenAI.

The OpenAI API is powered by a diverse set of models with different capabilities and price points. Automatic selection chooses the best model available, but you might want to choose a specific model that matches your needs.

Automatic and predefined model selection queries the service model-listing endpoint. Automatic selection prefers current general-purpose models that balance translation quality, response time, and price, using older GPT models only as compatibility fallbacks. Choose Custom model when using an OpenAI-compatible gateway that does not provide model discovery; Weblate sends the configured model identifier directly to the chat completions endpoint.

Use persona and style fields to further fine-tune translations. These will be used in a prompt for OpenAI and allow you to change the style of the translations.

The service automatically uses Glossario, see Glossaries in translation services.

Cambiato nella versione 5.7: Support for custom model and base URL was added.

Vedi anche

SAP Translation Hub¶

ID servizio:

sap-translation-hub

Maximum score:

100

Configurazione:

`source_language`	Selezione lingua sorgente	Scelte disponibili: `auto` – Selezione automatica `source` – Linguaggio di origine del componente `secondary` – Lingua secondaria definita nel progetto o nel componente
`url`	URL API
`key`	Chiave API
`username`	Nome utente SAP
`password`	Password SAP
`enable_mt`	Abilita traduzione automatica
`domain`	Dominio traduzione	L’ID di un dominio traduzione, ad esempio BC. Se non specifichi un dominio, verranno cercate le traduzioni in tutti i domini disponibili.

Machine translation service provided by SAP.

You need to have a SAP account (and the SAP Translation Hub enabled in the SAP Cloud Platform) to use this service.

You can also configure whether to also use machine translation services, in addition to the term database.

Nota

To access the Sandbox API, you need to set url and key.

To access the productive API, you need to set url, username and password.

Vedi anche

Systran¶

ID servizio:

systran

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

Chiave API

Traduzione automatica fornita da Systran.

This service uses an API, and you need to obtain API key at <https://translate.systran.net/en/account>.

tmserver¶

ID servizio:

tmserver

Maximum score:

100

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

url

URL API

You can run your own translation memory server by using a tmserver protocol.

The original tmserver was bundled with the translate-toolkit.
amaGama server is an enhanced version of tmserver.

Nota

There currently does not seem to be a maintained server for this.

Weblate¶

ID servizio:: weblate
Maximum score:: 100
Configurazione:: This service has no configuration.

Weblate machine translation service can provide translations based on the exact matches of a string in the currently existing strings in a Translated, Approved, or Read-only states inside Weblate.

Weblate Translation Memory¶

ID servizio:: weblate-translation-memory
Maximum score:: 100
Configurazione:: This service has no configuration.

Use Memoria traduzione as a machine translation service. Any string that has been translated before (or uploaded to the translation memory) can be translated in this way. This suggestion source works with fuzzy matching.

Nota

Recreating Memoria traduzione reduces capabilities of this TM source.

Yandex¶

ID servizio:

yandex

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

Chiave API

Machine translation service provided by Yandex.

This service uses a Translation API, and you need to obtain an API key from Yandex.

Vedi anche

Yandex Translate API

Yandex v2¶

Added in version 5.1.

ID servizio:

yandex-v2

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

Chiave API

Machine translation service provided by Yandex.

This service uses a Translation API, and you need to obtain an API key from Yandex Cloud.

Vedi anche

Yandex Translate API v2

Youdao Zhiyun¶

ID servizio:

youdao-zhiyun

Maximum score:

Configurazione:

source_language

Selezione lingua sorgente

Scelte disponibili:

auto – Selezione automatica

source – Linguaggio di origine del componente

secondary – Lingua secondaria definita nel progetto o nel componente

key

ID client

secret

Segreto client

Machine translation service provided by Youdao.

This service uses an API, and you need to obtain an ID and an API key from Youdao.

Vedi anche

Youdao Zhiyun Natural Language Translation Service

Custom machine translation¶

You can also implement your own machine translation services using a few lines of Python code. Place the code in a module Weblate can import (see Creating a Python module or Codice di personalizzazione) and add fully qualified class name to WEBLATE_MACHINERY.

The rate_limit_window service class attribute controls the cooldown after Weblate detects rate limiting or certain service failures. Its default is 1800 seconds. When a service returns a retry delay, Weblate uses it instead: retry-after-ms takes precedence over Retry-After (seconds or an HTTP date), followed by Google RetryInfo details. Invalid delays are ignored. Valid delays can be shorter or longer than the service default.

Services with documented short-term throttling can override the default; for example, add rate_limit_window = 60 to your service class to retry after one minute. Translation and rephrasing use the same window with separate cooldown state.

Built-in services use a 60-second cooldown for Alibaba, Amazon Translate, Anthropic, Baidu, Google Cloud Translation Basic and Advanced, LibreTranslate, Mistral, OpenAI, and Azure OpenAI. Other services retain the default.

Cooldown expiry permits another request; it does not guarantee that a daily or billing quota has reset. The window also applies to custom endpoints configured for a service. Existing cached cooldowns expire at their original time.

"""
Machine translation example.

This example uses fictional http://example.com/ service to translate the
strings.
"""

from __future__ import annotations

from typing import TYPE_CHECKING

from weblate.machinery.base import MACHINERY_DEFAULT_THRESHOLD, MachineTranslation

if TYPE_CHECKING:
    from weblate.auth.models import User
    from weblate.machinery.base import DownloadTranslations
    from weblate.trans.models import Unit


class SampleTranslation(MachineTranslation):
    """Sample machine translation interface."""

    name = "Sample"

    def download_languages(self) -> list[str]:
        """Return list of languages your machine translation supports."""
        response = self.request("get", "http://example.com/languages")
        return response.json()["languages"]

    def download_translations(
        self,
        source_language: str,
        target_language: str,
        text: str,
        unit: Unit | None,
        user: User | None,
        threshold: int = MACHINERY_DEFAULT_THRESHOLD,
    ) -> DownloadTranslations:
        """Return tuple with translations."""
        response = self.request(
            "get",
            "http://example.com/translate",
            params={
                "source_language": source_language,
                "target_language": target_language,
                "text": text,
            },
        )

        for translation in response.json()["translations"]:
            yield {
                "text": translation,
                "quality": 100,
                "service": self.name,
                "source": text,
            }

Vedi anche