Translate a File

POST

https://libretranslate.com/translate_file

Translate a File

curl -X POST 'https://libretranslate.com/translate_file' \
  --form-string 'source=en' \
  --form-string 'target=es' \
  --form-string 'api_key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'

const form = new FormData();
form.append('source', 'en');
form.append('target', 'es');
form.append('api_key', 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx');
const response = await fetch('https://libretranslate.com/translate_file', {
  method: 'POST',
  headers: {},
  body: form,
});
console.log(await response.text());

import requests
from contextlib import ExitStack

with ExitStack() as stack:
    files = [
        ('source', (None, 'en')),
        ('target', (None, 'es')),
        ('api_key', (None, 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx')),
    ]
    response = requests.request('POST', 'https://libretranslate.com/translate_file', headers={}, files=files)
    print(response.text)

Request Body

{
  "file": "<binary>",
  "source": "en",
  "target": "es",
  "api_key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

{
  "translatedFileUrl": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Body

multipart/form-data

filestring<binary>required

File to translate

sourcestringrequired

Source language code or “auto” for auto detection

Example

en

targetstringrequired

Target language code

Example

es

api_keystring

API key

Example

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx