Microsoft Translator (Preview)

Microsoft Translator (Preview)

Microsoft Translator lets you translate text across multiple languages.

Note:

  • This is a Standard connector.

To create a connection, select the "Microsoft Translator" source and specify your subscription key for Microsoft Translator Text API into the Subscription Key field, or leave it blank to use an internal shared key.

  • If no subscription key is provided, the shared API key will be used, which comes with built-in throttling limits based on the number of characters that are being translated, specifically 55,000 characters per day and 100 requests per minute.
  • If you provide your own subscription key, there will be no characters limit used by the connector and the rate limit will be raised to 1000 requests per minute. In this case the Translator API will enforce limits based on your subscription (learn more here).

Only 2 connections can be created per account, if you see an error creating a new connection please check your connections list for existing Microsoft Translator connections.

Throttling Limits

Name Calls Renewal Period
API calls per connection 1000 60 seconds

Connections per account: 2

Creating a connection

To connect your account, you will need the following information:

Subscription Key
securestring
Specify your subscription key for Microsoft Translator Text API, or leave it blank to use an internal shared key. If empty, your API calls will be throttled based on a fixed internal limit.

Actions

Detect language

Detects the source language of the given text.

Required Parameters

Text
string
The text to translate.

Returns

Detected Language
Language

Language Model for Microsoft Translator translatable languages

Get languages

Retrieves all languages that Microsoft Translator supports.

Required Parameters

Text
string
The text to translate.

Returns

array of Language

Get speech languages

Retrieves the languages available for speech synthesis.

Required Parameters

Text
string
The text to translate.

Returns

array of Language

Text to speech

Converts a given text into speech as an audio stream in wave format.

Required Parameters

Text
string
The text to translate.
Language Code
string
Language code to generate speech (example: 'en-us').

Optional Parameters

Format
string
The audio format to return (default is audio/wav).
Options
string
Other options for the format (default is MinSize). Valid options are 'MinSize' or 'MaxQuality'.

Returns

Audio File
binary

Translate text

Translates text to a specified language using Microsoft Translator.

Required Parameters

Text
string
The text to translate.
Target Language
string
The target language code (example: 'fr').

Optional Parameters

Source Language
string
The source language (if not provided, Microsoft Translator will try to auto-detect) (example: en).
Category
string
The translation category (default: 'general').
Content Type
string
The content type (default: 'text/plain').

Returns

Translated Text
string

Definitions

Language

Language Model for Microsoft Translator translatable languages

Language Code
string
Gets or sets the language code.
Language Name
string
Gets or sets the language name.