#DevHack: use the synchronous Azure translation API in Node

The Azure AI Translator service has a new synchronous API in preview. The nice thing about this API is that it does not require any Azure Storage account to be set up to which you typically need to upload the files to be translated. Instead, you can just send the document to be translated directly to the API and you will get the translated document back.

In this post, I will show you how to use the synchronous Azure translation API in Node.js.

Calling the synchronous Azure translation API

To call the synchronous Azure translation API, you need to send a POST request to the https://{your-instance}.cognitiveservices.azure.com/translator/document:translate endpoint with form data containing the document to be translated.

Here is an example of how you can call the synchronous Azure translation API in Node.js:

1
import { readFile } from 'node:fs/promises';
2
import { blob } from 'node:stream/consumers';
3

4
const sourceLanguage = "en";
5
const targetLanguage = "nl";
6

7
const api = "https://{your-instance}.cognitiveservices.azure.com/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version=2023-11-01-preview";
8

9
const response = await fetch(api, {
10
  method: 'POST',
11
  headers: {
12
    'Ocp-Apim-Subscription-Key': '{your-subscription-key}',
13
  },
14
  body: formData
15
});
16

17
if (!response.ok) {
18
  console.log(`Error: ${response.status} ${response.statusText}`);
19
  console.log(await response.text());
20
} else {
21
  const data = await response.text();
22
  console.log(data);
23
}

That’s it! You have now successfully called the synchronous Azure translation API in Node.js.