Translate

POST

Translate text from one language to another.

Request

This endpoint expects an object.

text

stringRequired

The text to check for toxicity.

source_lang

stringRequired

The source language of the text.

target_lang

stringRequired

The target language for the translation.

use_third_party_engine

booleanOptional

Enables/disables third party translations.

Response

This endpoint returns an object

stringOptional

Unique ID for the chat completion.

object

stringOptional

Type of object (chat completion).

created

integerOptional

Timestamp of when the chat completion was created.

best_translation

stringOptional

The best translation of the input text.

best_score

doubleOptional

The best score for the best translation.

best_translation_model

stringOptional

The model used for the best translation.

translations

list of objectsOptional

The set translations from different models.

Errors

POST

1 curl -X POST https://api.predictionguard.com/translate \
2      -H "x-api-key: <apiKey>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "text": "The sky is blue.",
6   "source_lang": "eng",
7   "target_lang": "spa",
8   "use_third_party_engine": true
9 }'

1 {
2   "id": "translation-52929bae5c2c44c9b5177921958cb5f7",
3   "object": "translation",
4   "created": 1721136682,
5   "best_translation": "Le ciel est bleu.",
6   "best_score": 0.8694148659706116,
7   "best_translation_model": "hermes_2_pro_llama_3_8b",
8   "translations": [
9     {
10       "score": 0.8694148659706116,
11       "translation": "Le ciel est bleu.",
12       "model": "hermes_2_pro_llama_3_8b",
13       "status": "success"
14     },
15     {
16       "score": 0.8694148659706116,
17       "translation": "Le ciel est bleu.",
18       "model": "hermes_2_pro_mistral_7b",
19       "status": "success"
20     },
21     {
22       "score": 0.8694148659706116,
23       "translation": "Le ciel est bleu.",
24       "model": "openai",
25       "status": "success"
26     },
27     {
28       "score": 0.8694148659706116,
29       "translation": "Le ciel est bleu.",
30       "model": "deepl",
31       "status": "success"
32     },
33     {
34       "score": 0.8694148659706116,
35       "translation": "Le ciel est bleu.",
36       "model": "google",
37       "status": "success"
38     }
39   ]
40 }

Built with

1	curl -X POST https://api.predictionguard.com/translate \
2	-H "x-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"text": "The sky is blue.",
6	"source_lang": "eng",
7	"target_lang": "spa",
8	"use_third_party_engine": true
9	}'

1	{
2	"id": "translation-52929bae5c2c44c9b5177921958cb5f7",
3	"object": "translation",
4	"created": 1721136682,
5	"best_translation": "Le ciel est bleu.",
6	"best_score": 0.8694148659706116,
7	"best_translation_model": "hermes_2_pro_llama_3_8b",
8	"translations": [
9	{
10	"score": 0.8694148659706116,
11	"translation": "Le ciel est bleu.",
12	"model": "hermes_2_pro_llama_3_8b",
13	"status": "success"
14	},
15	{
16	"score": 0.8694148659706116,
17	"translation": "Le ciel est bleu.",
18	"model": "hermes_2_pro_mistral_7b",
19	"status": "success"
20	},
21	{
22	"score": 0.8694148659706116,
23	"translation": "Le ciel est bleu.",
24	"model": "openai",
25	"status": "success"
26	},
27	{
28	"score": 0.8694148659706116,
29	"translation": "Le ciel est bleu.",
30	"model": "deepl",
31	"status": "success"
32	},
33	{
34	"score": 0.8694148659706116,
35	"translation": "Le ciel est bleu.",
36	"model": "google",
37	"status": "success"
38	}
39	]
40	}