Azure Document Translator - Unable to translate images within documents using .NET SDK

Hi Aaron Schraufnagel

Thank you for bringing this to our attention. We are currently checking the details and working on resolving the issue. We’ll update you as soon as we have more information.

Hi Aaron Schraufnagel,

Welcome to Microsoft Q&A and Thank you for your question.

I understand that you’re inquiring about translating text within images in documents using the Azure AI Document Translation service, specifically through the .NET SDK.

Here’s the current status of translating text inside images when using Azure AI Document Translation, especially from the .NET SDK:

1. Support for Image Translation in the .NET SDK

At this time, image translation (text embedded inside images) is not supported in the Azure AI Document Translation .NET SDK.

The functionality is available only through the REST API, using the translateTextWithinImage (or translateImageText) option. This is why you’re seeing it documented under the REST API but not in the .NET SDK—SDKs generally receive new features after they mature in the REST layer.

2. Timeline

Currently There is no public roadmap, ETA, or announcement about when image translation will be added to the .NET SDK.

As of now, Microsoft has not announced SDK support for this feature.

Recommended Approach

If you need to translate text inside images today, the supported approach is:

Use the REST API for jobs requiring translateTextWithinImage, continue using the .NET SDK for standard document translation workflows, You can safely combine both REST + SDK in the same application if required

The feature works with the Batch Document Translation API and is currently supported for .docx documents.

You must pass the translateTextWithinImage: true option in the request.

Example Request

{
  "inputs": [
    {
      "source": {
        "sourceUrl": "YOUR_SAS_URL",
        "language": "en"
      },
      "targets": [
        {
          "targetUrl": "YOUR_TARGET_SAS_URL",
          "language": "ta"
        }
      ]
    }
  ],
  "options": {
    "translateTextWithinImage": true
  }
}

Please refer this

• REST API Documentation
• Batch Document Translation API

I Hope this helps. Do let me know if you have any further queries.

Thank you!

Thank you @SRILAKSHMI C , this is very helpful.

I updated to point to the REST API for translating documents w/images, however, it is still failing to translate the images. For context, this is a .docx file with an image, using the batch translation API (version 2024-05-01) and the AI services resource (not the standalone Translator). Here is the format of the request that is being sent:

{

"inputs": [

{

  "source": {

    "sourceUrl": "<omitted>",

    "language": "es"

  },

  "targets": [

    {

      "targetUrl": "<omitted>",

      "language": "en"

    }

  ]

}
],

  "options": {

	"translateTextWithinImage": true
  }

}