Automatic Translation

post

https://api.edenai.run/v2/translation/automatic_translation/

Available Providers

Provider	Model	Version	Price	Billing unit
amazon	-	`boto3 (v1.15.18)`	15.0 (per 1000000 char)	1 char
google	-	`v3`	20.0 (per 1000000 char)	1 char
microsoft	-	`v3.0`	10.0 (per 1000000 char)	1 char
deepl	-	`v2`	20.0 (per 1000000 char)	1 char
modernmt	-	`1.2.8`	8.0 (per 1000000 char)	1 char
openai	-	`v1`	20.0 (per 1000000 token)	1 token
openai	gpt-4o	`v1`	20.0 (per 1000000 token)	1 token

Supported Languages

Name	Value
Afrikaans	`af`
Albanian	`sq`
Amharic	`am`
Arabic	`ar`
Armenian	`hy`
Assamese	`as`
Azerbaijani	`az`
Bashkir	`ba`
Basque	`eu`
Belarusian	`be`
Bengali	`bn`
Bosnian	`bs`
Bulgarian	`bg`
Burmese	`my`
Catalan	`ca`
Cebuano	`ceb`
Chinese	`zh`
Corsican	`co`
Croatian	`hr`
Czech	`cs`
Danish	`da`
Dari	`prs`
Dhivehi	`dv`
Dutch	`nl`
English	`en`
Esperanto	`eo`
Estonian	`et`
Faroese	`fo`
Fijian	`fj`
Filipino	`fil`
Finnish	`fi`
French	`fr`
Galician	`gl`
Georgian	`ka`
German	`de`
Gujarati	`gu`
Haitian	`ht`
Hausa	`ha`
Hawaiian	`haw`
Hebrew	`he`
Hindi	`hi`
Hmong	`hmn`
Hmong Daw	`mww`
Hungarian	`hu`
Icelandic	`is`
Igbo	`ig`
Indonesian	`id`
Inuinnaqtun	`ikt`
Inuktitut	`iu`
Irish	`ga`
Italian	`it`
Japanese	`ja`
Javanese	`jv`
Kannada	`kn`
Kazakh	`kk`
Khmer	`km`
Kinyarwanda	`rw`
Kirghiz	`ky`
Klingon	`tlh`
Korean	`ko`
Kurdish	`ku`
Lao	`lo`
Latin	`la`
Latvian	`lv`
Literary Chinese	`lzh`
Lithuanian	`lt`
Luxembourgish	`lb`
Macedonian	`mk`
Malagasy	`mg`
Malay (macrolanguage)	`ms`
Malayalam	`ml`
Maltese	`mt`
Maori	`mi`
Marathi	`mr`
Modern Greek (1453-)	`el`
Mongolian	`mn`
Nepali (macrolanguage)	`ne`
Northern Kurdish	`kmr`
Norwegian	`no`
Norwegian Bokmål	`nb`
Norwegian Nynorsk	`nn`
Nyanja	`ny`
Oriya (macrolanguage)	`or`
Panjabi	`pa`
Persian	`fa`
Polish	`pl`
Portuguese	`pt`
Pushto	`ps`
Querétaro Otomi	`otq`
Romanian	`ro`
Russian	`ru`
Samoan	`sm`
Scottish Gaelic	`gd`
Serbian	`sr`
Shona	`sn`
Sindhi	`sd`
Sinhala	`si`
Slovak	`sk`
Slovenian	`sl`
Somali	`so`
Southern Sotho	`st`
Spanish	`es`
Sundanese	`su`
Swahili (macrolanguage)	`sw`
Swedish	`sv`
Tagalog	`tl`
Tahitian	`ty`
Tajik	`tg`
Tamil	`ta`
Tatar	`tt`
Telugu	`te`
Thai	`th`
Tibetan	`bo`
Tigrinya	`ti`
Tonga (Tonga Islands)	`to`
Turkish	`tr`
Turkmen	`tk`
Uighur	`ug`
Ukrainian	`uk`
Upper Sorbian	`hsb`
Urdu	`ur`
Uzbek	`uz`
Vietnamese	`vi`
Welsh	`cy`
Western Frisian	`fy`
Xhosa	`xh`
Yiddish	`yi`
Yoruba	`yo`
Yucateco	`yua`
Yue Chinese	`yue`
Zulu	`zu`

Supported Detailed Languages

Name	Value
Auto detection	`auto-detect`
Chinese (China)	`zh-CN`
Chinese (Simplified)	`zh-Hans`
Chinese (Taiwan)	`zh-TW`
Chinese (Traditional)	`zh-Hant`
English (United Kingdom)	`en-GB`
English (United States)	`en-US`
French (Canada)	`fr-CA`
Inuktitut (Latin)	`iu-Latn`
Klingon (Klingon (KLI pIqaD))	`tlh-Piqd`
Klingon (Latin)	`tlh-Latn`
Mongolian (Cyrillic)	`mn-Cyrl`
Mongolian (Mongolian)	`mn-Mong`
Persian (Afghanistan)	`fa-AF`
Portuguese (Brazil)	`pt-BR`
Portuguese (Portugal)	`pt-PT`
Serbian (Cyrillic)	`sr-Cyrl`
Serbian (Latin)	`sr-Latn`
Spanish (Latin America)	`es-419`
Spanish (Mexico)	`es-MX`
Spanish (Spain)	`es-ES`

Supported Models

Default Models

Name	Value
openai	`gpt-4o`

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

settings

string

Defaults to [object Object]

A dictionnary or a json object to specify specific models to use for some providers.
It can be in the following format: {"google" : "google_model", "ibm": "ibm_model"...}.

providers

array of strings

required

It can be one (ex: 'amazon' or 'google') or multiple provider(s) (ex: 'amazon,microsoft,google') that the data will be redirected to in order to get the processed results.
Providers can also be invoked with specific models (ex: providers: 'amazon/model1, amazon/model2, google/model3')

providers*

fallback_providers

array of strings

length ≤ 5

Defaults to

Providers in this list will be used as fallback if the call to provider in providers parameter fails. To use this feature, you must input only one provider in the providers parameter. but you can put up to 5 fallbacks.

They will be tried in the same order they are input, and it will stop to the first provider who doesn't fail.

Doesn't work with async subfeatures.

fallback_providers

response_as_dict

boolean

Defaults to true

Optional : When set to true (default), the response is an object of responses with providers names as keys :
{"google" : { "status": "success", ... }, }
When set to false the response structure is a list of response objects :
[{"status": "success", "provider": "google" ... }, ].

attributes_as_list

boolean

Defaults to false

Optional : When set to false (default) the structure of the extracted items is list of objects having different attributes :
{'items': [{"attribute_1": "x1","attribute_2": "y2"}, ... ]}
When it is set to true, the response contains an object with each attribute as a list :
{ "attribute_1": ["x1","x2", ...], "attribute_2": [y1, y2, ...]}

show_base_64

boolean

Defaults to true

show_original_response

boolean

Defaults to false

Optional : Shows the original response of the provider.
When set to true, a new attribute original_response will appear in the response object.

text

string

required

length ≥ 1

Text to analyze

source_language

string | null

Source language code (ex: en, fr)

target_language

string

required

length ≥ 1

Target language code (ex: en, fr)

Responses

200

400

403

404

500