Repository navigation
Add support for Translator Text API 2026-06-06 #2693
Description
Is your feature request related to a problem? Please describe.
SynapseML's text Translator transformers currently hardcode api-version=3.0 and use the v3.0 request and response schemas. Azure Translator Text API 2026-06-06 is now the latest GA version, but it isn't backward compatible with v3.0.
For example:
Translatesends target languages as the v3.0toquery parameter and serializes the body as[{"Text":"..."}].- The common text request builder and other Translator operations also hardcode
api-version=3.0. - Response types such as
TranslateResponseandTransliterateResponserepresent the v3.0 response shape. - Methods including Detect, BreakSentence, Dictionary Lookup, and Dictionary Examples aren't available in API
2026-06-06.
As a result, users can't opt into the latest GA Translator API or its new capabilities through SynapseML by changing a version parameter. Changing only the version string would break request serialization, response parsing, and unsupported operations.
Describe the solution you'd like
Add explicit, version-aware support for Translator Text API 2026-06-06 while preserving existing v3.0 behavior for backward compatibility. The implementation should:
- Provide a supported way to select API
2026-06-06, or introduce version-specific transformers if the contracts differ too much for one class. - Implement the
2026-06-06request schema, includinginputsand translationtargets. - Implement the wrapped
valueresponse schemas for supported operations. - Support the
2026-06-06Translate, Transliterate, and Languages operations. - Prevent or clearly reject v3.0-only operations when
2026-06-06is selected. - Add request-building, schema, serialization, and response-parsing tests for both versions.
- Document the compatibility and migration behavior.
Additional context
- Migration guide: https://learn.microsoft.com/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06
- Current hardcoded API version:
cognitive/src/main/scala/com/microsoft/azure/synapse/ml/services/translate/TextTranslator.scala - Current response schemas:
cognitive/src/main/scala/com/microsoft/azure/synapse/ml/services/translate/TranslatorSchemas.scala - Current tests explicitly assert
api-version=3.0:cognitive/src/test/scala/com/microsoft/azure/synapse/ml/services/translate/TextTranslatorCoreSuite.scala
This request doesn't assume a retirement date for v3.0; it tracks support for the latest GA API and its new functionality.
Activity
github-actions commentedon Sep 4, 2026
Hey Rana Singh (@ranadeepsingh) 👋!
Thank you so much for reporting the issue/feature request 🚨.
Someone from SynapseML Team will be looking to triage this issue soon.
We appreciate your patience.
fix: harden Translator request array handling
fix: stabilize Translator Languages scope errors
fix: allow neutral Translator 2026 controls
feat: update Translator and AnalyzeText API support (#2696)