4.3.0 • Published 1 month ago

bing-translate-api

Licence

MIT

Version

4.3.0

Deps

Size

51 kB

Vulns

Weekly

Summary Dependency Versions

bing-translate-api

A simple and free API for Bing Translator and Microsoft Translator for Node.js.

Install

npm install bing-translate-api

Usage

Microsoft Translator

Available since v4.0.0. More stable and powerful than the Bing Translator, supporting both free and paid tiers.

Check the README for more details.

Bing Translator

From auto-detected language to English:

const { translate } = require('bing-translate-api');

translate('你好', null, 'en').then(res => {
  console.log(res.translation);
}).catch(err => {
  console.error(err);
});

Translation result

{
  // original text
  "text": "你好",
  // user-specified language code
  "userLang": "auto-detect",
  // translated text
  "translation": "Hello",
  // `correctedText` is returned only when `correct` is set as `true`
  // supported since v1.1.0
  "correctedText": "",
  // detected language
  "language": {
    // language code of translated text
    "to": "en",
    // detected language code of original text
    "from": "zh-Hans",
    // score of language detection
    // supported since v1.1.0
    // (NOTICE: This field may not be provided at present)
    "score": 1
  },
  // feminine translation text (Only be returned when the translation result is gender-debiased)
  // supported since v4.1.0
  "feminineTranslation": undefined,
  // masculine translation text (Only be returned when the translation result is gender-debiased)
  // supported since v4.1.0
  "masculineTranslation": undefined
}

API

translate(text, [from], [to], [correct], [raw], [userAgent], [proxyAgents])

text

Type: string

The text to be translated, can't be blank. The maximum text length is 1000.

NOTE:

The maximum text length is up to 5000 characters only in China.
In EPT mode (since v3.0.0), the maximum text length is currently 3000.

from

Type: string Default: auto-detect

The language code of source text.

MUST be auto-detect or one of the codes/names (not case sensitive) contained in lang.json

NOTE: The EPT mode (since v3.0.0) only supports the languages contained in src/config.json#eptLangs. Any other language will fall back to the legacy mode, in which a 429 (Too Many Requests) error often occurs.