translate

A library for free and not only using various translation APIs, which supports working with JavaScript, TypeScript, and also has built-in separated types for Typebox.

Installation

Installation via Bun:

bun add @toil/translate
Copy

Installation via NPM:

npm install @toil/translate
Copy

Getting started

To start working with the API, you need to create a Translation Client. This can be done using the code provided below.

const client = new TranslationClient({
  service: TranslationService.yandexbrowser,
});

const translatedResult = await client.translate(
  "The quick brown fox jumps over the lazy dog",
);

const detectResult = await client.detect(
  "The quick brown fox jumps over the lazy dog",
);

const langs = await client.getLangs();
Copy

You can see more code examples here

Available services

Status	Service	Functions	Limits
✅	YandexBrowser	Translate Detect GetLangs	10k chars/req 10k chars/req
✅	YandexCloud	Translate Detect GetLangs	2k chars/req 1k chars/req
✅	YandexTranslate	Translate Detect GetLangs	10k chars/req 10k chars/req
✅	YandexGPT*¹	Translate Detect GetLangs	10k chars/req 10k chars/req
✅	MSEdge	Translate Detect GetLangs	50k chars/req 50k chars/req
✅	Bing	Translate Detect GetLangs	1k chars/req 1k chars/req
✅	LibreTranslate*²	Translate Detect GetLangs	2k chars/req 2k chars/req

*¹ - translation using YandexGPT only works for the en-ru pair, For all other cases, a translation similar to YandexTranslate is used

*² - by default, obtaining a secret key is disabled. Please install apiKey or enable allowUnsafeEval when creating the client

Build

To build, you must have:

• Bun

Don't forget to install the dependencies:

bun install
Copy

Start building:

bun build:all
Copy

Tests

The library has minimal test coverage to check it's performance.

Run the tests:

bun test
Copy