Skip to content

Add support for Translator Text API 2026-06-06 #2693

Closed

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:

  • Translate sends target languages as the v3.0 to query 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 TranslateResponse and TransliterateResponse represent 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-06 request schema, including inputs and translation targets.
  • Implement the wrapped value response schemas for supported operations.
  • Support the 2026-06-06 Translate, Transliterate, and Languages operations.
  • Prevent or clearly reject v3.0-only operations when 2026-06-06 is 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

  1. github-actions commented on Sep 4, 2026

    @github-actions

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions