From 709e6d424410ab3fdf5f335c04a442bcd6299496 Mon Sep 17 00:00:00 2001 From: Maxim Brunnmeier Date: Wed, 9 Sep 2026 11:15:59 +0200 Subject: [PATCH 1/2] docs: document the minimum translation memory threshold Text translation treats a translation_memory_threshold below 50 as 50. The accepted request range is unchanged, so the schema still allows 0-100. The note names POST /v2/translate because the schema is shared with POST /v2/document, which passes the value through unchanged. --- api-reference/openapi.json | 2 +- api-reference/openapi.yaml | 2 +- docs/customize/using-translation-memories.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/openapi.json b/api-reference/openapi.json index 72e5e2cc..55676724 100644 --- a/api-reference/openapi.json +++ b/api-reference/openapi.json @@ -9683,7 +9683,7 @@ }, "TranslationMemoryThreshold": { "type": "integer", - "description": "The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher).", + "description": "The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). On `POST /v2/translate`, a value below 50 is treated as 50.", "minimum": 0, "maximum": 100, "default": 75, diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml index 8fe39562..5e16a30d 100644 --- a/api-reference/openapi.yaml +++ b/api-reference/openapi.yaml @@ -7053,7 +7053,7 @@ components: example: 12 TranslationMemoryThreshold: type: integer - description: The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). + description: The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). On `POST /v2/translate`, a value below 50 is treated as 50. minimum: 0 maximum: 100 default: 75 diff --git a/docs/customize/using-translation-memories.mdx b/docs/customize/using-translation-memories.mdx index 7c10354f..eec21c8b 100644 --- a/docs/customize/using-translation-memories.mdx +++ b/docs/customize/using-translation-memories.mdx @@ -100,7 +100,7 @@ Notice that we didn't need to specify `source_lang` — language auto-detection ## Step 3: Adjust the matching threshold -By default, a stored segment is applied when it matches at least **75%** of the source text. This means translation memory segments can match even when the source text isn't identical — which is useful for catching typos and minor variations. +By default, a stored segment is applied when it matches at least **75%** of the source text. This means translation memory segments can match even when the source text isn't identical — which is useful for catching typos and minor variations. The lowest supported threshold is 50, and text translation treats a lower value as 50. Let's see this in action. Imagine we make a typo and send "Halloo Welt!" instead of "Hallo Welt!": From 6d6c871acd3c13da8e81baf850eacb3984069e19 Mon Sep 17 00:00:00 2001 From: Maxim Brunnmeier Date: Fri, 11 Sep 2026 11:54:59 +0200 Subject: [PATCH 2/2] docs: apply the minimum translation memory threshold to both endpoints Document translation now raises a value below 50 to 50 as well, so the note on the shared schema no longer needs to name a single endpoint. --- api-reference/openapi.json | 2 +- api-reference/openapi.yaml | 2 +- docs/customize/using-translation-memories.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/api-reference/openapi.json b/api-reference/openapi.json index 55676724..a18d236b 100644 --- a/api-reference/openapi.json +++ b/api-reference/openapi.json @@ -9683,7 +9683,7 @@ }, "TranslationMemoryThreshold": { "type": "integer", - "description": "The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). On `POST /v2/translate`, a value below 50 is treated as 50.", + "description": "The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). A value below 50 is treated as 50.", "minimum": 0, "maximum": 100, "default": 75, diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml index 5e16a30d..03dede5e 100644 --- a/api-reference/openapi.yaml +++ b/api-reference/openapi.yaml @@ -7053,7 +7053,7 @@ components: example: 12 TranslationMemoryThreshold: type: integer - description: The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). On `POST /v2/translate`, a value below 50 is treated as 50. + description: The minimum matching percentage required for a translation memory segment to be applied (recommended to be 75% or higher). A value below 50 is treated as 50. minimum: 0 maximum: 100 default: 75 diff --git a/docs/customize/using-translation-memories.mdx b/docs/customize/using-translation-memories.mdx index eec21c8b..44472d89 100644 --- a/docs/customize/using-translation-memories.mdx +++ b/docs/customize/using-translation-memories.mdx @@ -100,7 +100,7 @@ Notice that we didn't need to specify `source_lang` — language auto-detection ## Step 3: Adjust the matching threshold -By default, a stored segment is applied when it matches at least **75%** of the source text. This means translation memory segments can match even when the source text isn't identical — which is useful for catching typos and minor variations. The lowest supported threshold is 50, and text translation treats a lower value as 50. +By default, a stored segment is applied when it matches at least **75%** of the source text. This means translation memory segments can match even when the source text isn't identical — which is useful for catching typos and minor variations. The lowest supported threshold is 50, and a lower value is treated as 50. Let's see this in action. Imagine we make a typo and send "Halloo Welt!" instead of "Hallo Welt!":