LibreTranslate

https://docs.libretranslate.com
Admin
LibreTranslate is a free and open-source machine translation API that is self-hosted and powered by...
Tokens:7,717
Snippets:108
Trust Score:9.4
Update:2 months ago
Show doc for...
Tokens:
Raw
### Run Development Server

Source: https://docs.libretranslate.com/guides/build_from_sources

Start the application in development mode.

```bash
hatch run dev --debug
```

--------------------------------

### Translate Text Parameter Examples

Source: https://docs.libretranslate.com/api/operations/translate

Examples of valid input formats for the 'q' parameter, accepting either a single string or an array of strings.

```text
Hello world!
```

```text
[
  "Hello world!"
]
```

--------------------------------

### Install LibreTranslate on Kubernetes with Helm

Source: https://docs.libretranslate.com/guides/installation

Commands to add the repository and install the chart into a specific namespace.

```bash
helm repo add libretranslate https://libretranslate.github.io/helm-chart/
helm repo update
helm search repo libretranslate


helm install libretranslate libretranslate/libretranslate --namespace libretranslate --create-namespace
```

--------------------------------

### Install Hatch

Source: https://docs.libretranslate.com/guides/build_from_sources

Install the Hatch project manager to handle dependencies and development scripts.

```bash
pipx install hatch
```

--------------------------------

### Self-Host LibreTranslate and Translate Text

Source: https://docs.libretranslate.com/

Install the package, start the server, and perform a translation request via cURL.

```bash
$ pip install libretranslate
$ libretranslate
$ curl -X POST http://localhost:5000/translate -d q="Hello" -d source=en -d target=es
```

```json
{"translatedText":"Hola"}
```

--------------------------------

### Run LibreTranslate container

Source: https://docs.libretranslate.com/guides/faq

Start the LibreTranslate container bound to localhost for reverse proxy access.

```bash
sudo docker run -ti --rm -p 127.0.0.1:5000:5000 libretranslate/libretranslate
```

--------------------------------

### Externally Managed Environment Error

Source: https://docs.libretranslate.com/guides/build_from_sources

Example of the error message encountered when installing packages in an externally managed environment.

```text
error: externally-managed-environment


× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.


    …
```

--------------------------------

### Enable and start the systemd service

Source: https://docs.libretranslate.com/guides/faq

Commands to reload the daemon and manage the service lifecycle after creating the configuration file.

```bash
systemctl daemon-reload
systemctl start libretranslate.service
systemctl enable libretranslate.service
```

--------------------------------

### Run with Gunicorn and Prometheus

Source: https://docs.libretranslate.com/guides/installation

Commands to set up the multiprocess directory and start the application with Gunicorn.

```bash
mkdir -p /tmp/prometheus_data
rm /tmp/prometheus_data/*
export PROMETHEUS_MULTIPROC_DIR=/tmp/prometheus_data
gunicorn -c scripts/gunicorn_conf.py --bind 0.0.0.0:5000 'wsgi:app(metrics=True)'
```

--------------------------------

### API Key Parameter

Source: https://docs.libretranslate.com/api/operations/translate

Example format for the API key authentication string.

```text
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

--------------------------------

### Source Language Parameter

Source: https://docs.libretranslate.com/api/operations/translate

Example value for the source language parameter.

```text
en
```

--------------------------------

### Alternatives Parameter

Source: https://docs.libretranslate.com/api/operations/translate

Example value for the number of preferred alternative translations.

```text
3
```

--------------------------------

### Format Parameter

Source: https://docs.libretranslate.com/api/operations/translate

Example value for the format parameter, specifying plain text or HTML.

```text
text
```

--------------------------------

### Install and run LibreTranslate with Python

Source: https://docs.libretranslate.com/guides/installation

Requires Python 3.8 or higher. Use the --load-only argument to limit language support and reduce startup time.

```bash
pip install libretranslate
libretranslate [args]
```

```bash
libretranslate --load-only en,es,fr
```

```bash
ARGOS_CHUNK_TYPE=MINISBD libretranslate [...]
```

--------------------------------

### Target Language Parameter

Source: https://docs.libretranslate.com/api/operations/translate

Example value for the target language parameter.

```text
es
```

--------------------------------

### Prometheus Metrics Output

Source: https://docs.libretranslate.com/guides/installation

Example output format for the /metrics endpoint.

```text
# HELP libretranslate_http_requests_in_flight Multiprocess metric
# TYPE libretranslate_http_requests_in_flight gauge
libretranslate_http_requests_in_flight{api_key="",endpoint="/translate",request_ip="127.0.0.1"} 0.0
# HELP libretranslate_http_request_duration_seconds Multiprocess metric
# TYPE libretranslate_http_request_duration_seconds summary
libretranslate_http_request_duration_seconds_count{api_key="",endpoint="/translate",request_ip="127.0.0.1",status="200"} 0.0
libretranslate_http_request_duration_seconds_sum{api_key="",endpoint="/translate",request_ip="127.0.0.1",status="200"} 0.0
```

--------------------------------

### GET /frontend/settings

Source: https://docs.libretranslate.com/api/operations/frontendsettings

Retrieves the current configuration settings for the frontend, including limits, requirements, and language support.

```APIDOC
## GET /frontend/settings

### Description
Retrieves the current configuration settings for the frontend, including limits, requirements, and language support.

### Method
GET

### Endpoint
/frontend/settings

### Response
#### Success Response (200)
- **apiKeys** (boolean) - Whether the API key database is enabled.
- **charLimit** (integer) - Character input limit for this language (-1 indicates no limit).
- **frontendTimeout** (integer) - Frontend translation timeout.
- **keyRequired** (boolean) - Whether an API key is required.
- **language** (object) - Language configuration object.
  - **source** (object) - Source language details.
    - **code** (string) - Language code.
    - **name** (string) - Human-readable language name (in English).
  - **target** (object) - Target language details.
    - **code** (string) - Language code.
    - **name** (string) - Human-readable language name (in English).
- **suggestions** (boolean) - Whether submitting suggestions is enabled.
- **supportedFilesFormat** (Array<string>) - Supported files format.
```

--------------------------------

### Language Detection Input Parameters

Source: https://docs.libretranslate.com/api/operations/detect

Example values for the text to be detected and the API key authentication parameter.

```text
What language is this?
```

```text
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

--------------------------------

### GET /health

Source: https://docs.libretranslate.com/api/operations/health

Checks the health status of the service.

```APIDOC
## GET /health

### Description
Checks the health status of the service.

### Method
GET

### Endpoint
/health

### Response
#### Success Response (200)
- **status** (string) - Health status

#### Response Example
{
  "status": "ok"
}
```

--------------------------------

### Update LibreTranslate Software

Source: https://docs.libretranslate.com/guides/installation

Commands to update the LibreTranslate installation using pip or Docker.

```bash
pip install -U libretranslate
```

```bash
docker pull libretranslate/libretranslate
```

--------------------------------

### Confidence Value Response

Source: https://docs.libretranslate.com/api/operations/translate

Example value for the confidence score returned in the response object.

```text
100
```

--------------------------------

### Update language models in Docker

Source: https://docs.libretranslate.com/guides/faq

Execute this command within a running LibreTranslate container to update installed language models.

```bash
docker exec -it libretranslate ./venv/bin/python scripts/install_models.py --update
```

--------------------------------

### GET /languages

Source: https://docs.libretranslate.com/api/operations/languages

Retrieves a list of all supported languages, including their codes, names, and valid target languages for translation.

```APIDOC
## GET /languages

### Description
Retrieves a list of all supported languages available for translation.

### Method
GET

### Endpoint
/languages

### Response
#### Success Response (200)
- **Array<object>** - A list of supported language objects.

Each object contains:
- **code** (string) - Language code.
- **name** (string) - Human-readable language name (in English).
- **targets** (Array<string>) - Supported target language codes.

#### Response Example
[
  {
    "code": "en",
    "name": "English",
    "targets": ["es", "fr", "de"]
  }
]
```

--------------------------------

### Language Detection Response Fields

Source: https://docs.libretranslate.com/api/operations/detect

Example values for the confidence score and language code returned in the response.

```text
100
```

```text
en
```

--------------------------------

### Build and Run with Docker

Source: https://docs.libretranslate.com/guides/build_from_sources

Commands for building and running the application using Docker.

```bash
docker build -f docker/Dockerfile [--build-arg with_models=true] -t libretranslate .
```

```bash
docker run -it -p 5000:5000 libretranslate [args]
```

```bash
docker compose up -d --build
```

--------------------------------

### Run Test Suite

Source: https://docs.libretranslate.com/guides/build_from_sources

Execute tests and linting checks using Hatch.

```bash
hatch run test
```

```bash
hatch run test -s
```

```bash
hatch run all:test
```

--------------------------------

### Clone the LibreTranslate repository

Source: https://docs.libretranslate.com/guides/installation

Initial step for running the application via Docker.

```bash
git clone https://github.com/LibreTranslate/LibreTranslate
cd LibreTranslate
```

--------------------------------

### View API Keys

Source: https://docs.libretranslate.com/guides/manage_api_keys

Command to list all currently managed API keys.

```bash
ltmanage keys
```

--------------------------------

### Clone Repository

Source: https://docs.libretranslate.com/guides/build_from_sources

Download the source code from the official repository.

```bash
git clone https://github.com/LibreTranslate/LibreTranslate.git
cd LibreTranslate
```

--------------------------------

### Configure LibreTranslate as a systemd service

Source: https://docs.libretranslate.com/guides/faq

Create this service file in /etc/systemd/system to manage LibreTranslate as a background process.

```ini
[Unit]
Description=LibreTranslate
After=network.target
[Service]
User=root
Type=idle
Restart=always
Environment="PATH=/usr/local/lib/python3.11/dist-packages/libretranslate"
ExecStart=/usr/bin/python3 /usr/local/bin/libretranslate
EnvironmentFile=/usr/local/lib/python3.11/dist-packages/libretranslate/.env
ExecReload=/bin/kill -s HUP $MAINPID
KillMode=mixed
TimeoutStopSec=1
[Install]
WantedBy=multi-user.target
```

--------------------------------

### Deploy with Gunicorn

Source: https://docs.libretranslate.com/guides/installation

Production-ready deployment using Gunicorn. Application arguments can be passed directly to the wsgi app.

```bash
pip install gunicorn
gunicorn --bind 0.0.0.0:5000 'wsgi:app()'
```

```bash
gunicorn --bind 0.0.0.0:5000 'wsgi:app(api_keys=True)'
```

--------------------------------

### Access Virtual Environment

Source: https://docs.libretranslate.com/guides/build_from_sources

Open a shell within the project's virtual environment.

```bash
hatch shell
libretranslate [args]
# Or
python main.py [args]
```

--------------------------------

### Run LibreTranslate with CUDA support

Source: https://docs.libretranslate.com/guides/installation

Requires CUDA 12.4.1 and nvidia-docker. Uses a specific compose file for hardware acceleration.

```bash
docker compose -f docker-compose.cuda.yml up -d --build
```

--------------------------------

### Configure LibreTranslate for OpenCode

Source: https://docs.libretranslate.com/guides/mcp_server

Add this JSON configuration to your OpenCode client settings to enable the LibreTranslate MCP server.

```json
{
  "mcp": {
    "LibreTranslate": {
      "type": "local",
      "command": ["npx", "-y", "@libretranslate/mcp"],
      "environment": {
        "LIBRETRANSLATE_API_URL": "https://libretranslate.com",
        "LIBRETRANSLATE_API_KEY": "your-api-key"
      }
    }
  }
}
```

--------------------------------

### Manage Environments

Source: https://docs.libretranslate.com/guides/build_from_sources

Remove the virtual environment.

```bash
hatch env prune
```

--------------------------------

### Configure Discourse Plugin for LibreTranslate

Source: https://docs.libretranslate.com/guides/integrations

Add the discourse-translator plugin to the app.yml configuration file to enable LibreTranslate support.

```yaml
## Plugins go here
## see https://meta.discourse.org/t/19157 for details
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/discourse/discourse-translator
    ...
```

--------------------------------

### Add New API Key

Source: https://docs.libretranslate.com/guides/manage_api_keys

Commands to generate new API keys with specific request and character limits.

```bash
ltmanage keys add 120
```

```bash
ltmanage keys add 120 --char-limit 5000
```

```bash
ltmanage keys --api-keys-db-path path/to/db/dbName.db add 120
```

--------------------------------

### Update Language Models

Source: https://docs.libretranslate.com/guides/installation

Commands to trigger a model update during program startup or via a dedicated script.

```bash
libretranslate --update-models
```

```bash
./run.sh --update-models
```

```bash
scripts/install_models.py
```

--------------------------------

### Caddy reverse proxy configuration

Source: https://docs.libretranslate.com/guides/faq

Configure Caddy to proxy requests to the local LibreTranslate instance.

```caddy
#Libretranslate
[YOUR_DOMAIN] {
  reverse_proxy localhost:5000
}
```

--------------------------------

### Configure Prometheus Scrape

Source: https://docs.libretranslate.com/guides/installation

Configuration snippet for prometheus.yml to scrape LibreTranslate metrics.

```yaml
scrape_configs:
  - job_name: "libretranslate"


    # Needed only if you use --metrics-auth-token
    #authorization:
    #credentials: "mytoken"


    static_configs:
      - targets: ["localhost:5000"]
```

--------------------------------

### Configure LibreTranslate for Claude

Source: https://docs.libretranslate.com/guides/mcp_server

Add this JSON configuration to your Claude client settings to enable the LibreTranslate MCP server.

```json
{
  "mcpServers": {
    "libretranslate": {
      "command": "npx",
      "args": ["-y", "@libretranslate/mcp"],
      "env": {
        "LIBRETRANSLATE_API_URL": "https://libretranslate.com",
        "LIBRETRANSLATE_API_KEY": "your-api-key"
      }
    }
  }
}
```

--------------------------------

### Configure NGINX as a Reverse Proxy for LibreTranslate

Source: https://docs.libretranslate.com/guides/faq

Use this configuration to handle SSL termination and proxy requests to the LibreTranslate service running on port 5000. Replace [YOUR_DOMAIN] with your actual domain name before applying.

```nginx
server {
  listen 80;
  server_name [YOUR_DOMAIN];
  return 301 https://$server_name$request_uri;
}


server {
  listen 443 http2 ssl;
  server_name [YOUR_DOMAIN];


  #access_log off;
  #error_log off;


  # SSL Section
  ssl_certificate /etc/letsencrypt/live/[YOUR_DOMAIN]/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/[YOUR_DOMAIN]/privkey.pem;


  ssl_protocols TLSv1.2 TLSv1.3;


  # Using the recommended cipher suite from: https://wiki.mozilla.org/Security/Server_Side_TLS
  ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384';


  ssl_session_timeout 10m;
  ssl_session_cache shared:MozSSL:10m;  # about 40000 sessions
  ssl_session_tickets off;


  # Specifies a curve for ECDHE ciphers.
  ssl_ecdh_curve prime256v1;
  # Server should determine the ciphers, not the client
  ssl_prefer_server_ciphers on;




  # Header section
  add_header Strict-Transport-Security  "max-age=31536000; includeSubDomains; preload" always;
  add_header Referrer-Policy            "strict-origin" always;


  add_header X-Frame-Options            "SAMEORIGIN"    always;
  add_header X-XSS-Protection           "1; mode=block" always;
  add_header X-Content-Type-Options     "nosniff"       always;
  add_header X-Download-Options         "noopen"        always;
  add_header X-Robots-Tag               "none"          always;


  add_header Feature-Policy             "microphone 'none'; camera 'none'; geolocation 'none';"  always;
  # Newer header but not everywhere supported
  add_header Permissions-Policy         "microphone=(), camera=(), geolocation=()" always;


  # Remove X-Powered-By, which is an information leak
  fastcgi_hide_header X-Powered-By;


  # Do not send nginx server header
  server_tokens off;


  # GZIP Section
  gzip on;
  gzip_disable "msie6";


  gzip_vary on;
  gzip_proxied any;
  gzip_comp_level 6;
  gzip_buffers 16 8k;
  gzip_http_version 1.1;
  gzip_min_length 256;
  gzip_types text/xml text/javascript font/ttf font/eot font/otf application/x-javascript application/atom+xml application/javascript application/json application/manifest+json application/rss+xml application/x-web-app-manifest+json application/xhtml+xml application/xml image/svg+xml image/x-icon text/css text/plain;


  location / {
      proxy_pass http://127.0.0.1:5000/;
      proxy_set_header Host $http_host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto $scheme;
      client_max_body_size 0;
  }
}
```

--------------------------------

### Perform batch translations via API

Source: https://docs.libretranslate.com/guides/faq

Send an array of strings in the 'q' field to translate multiple segments in a single request.

```javascript
const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: ["Hello", "world"],
    source: "en",
    target: "es",
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
// {
//     "translatedText": [
//         "Hola",
//         "mundo"
//     ]
// }
```

--------------------------------

### POST /suggest

Source: https://docs.libretranslate.com/api/operations/suggest

Submits a suggestion to improve a translation.

```APIDOC
## POST /suggest

### Description
Submits a suggestion to improve a translation.

### Method
POST

### Endpoint
/suggest

### Parameters
#### FormData Parameters
- **q** (string) - Required - Original text
- **s** (string) - Required - Suggested translation
- **source** (string) - Required - Language of original text
- **target** (string) - Required - Language of suggested translation

### Response
#### Success Response (200)
- **success** (boolean) - Whether submission was successful

#### Error Response (403)
- **error** (string) - Error message
```

--------------------------------

### POST /detect

Source: https://docs.libretranslate.com/api/operations/detect

Detects the language of the provided text.

```APIDOC
## POST /detect

### Description
Detects the language of the provided text string.

### Method
POST

### Endpoint
/detect

### Parameters
#### FormData Parameters
- **q** (string) - Required - Text to detect
- **api_key** (string) - Optional - API key

### Response
#### Success Response (200)
- **Detections** (Array<object>) - List of detected languages
  - **confidence** (number) - Confidence value (float, <= 100)
  - **language** (string) - Language code

#### Error Responses
- **400** - Invalid request
- **403** - Banned
- **429** - Slow down
- **500** - Detection error
```

--------------------------------

### Perform Simple Translation with JavaScript

Source: https://docs.libretranslate.com/guides/api_usage

Translates text between specified languages. The api_key is optional for self-hosted instances.

```javascript
const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: "Hello!",
    source: "en",
    target: "es",
    api_key: "xxxxxx" // can be optional with self-hosting
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
```

```json
{
    "translatedText": "¡Hola!"
}
```

--------------------------------

### Submit translation suggestion parameters

Source: https://docs.libretranslate.com/api/operations/suggest

Required FormData parameters for the /suggest endpoint.

```text
Hello world!
```

```text
¡Hola mundo!
```

```text
en
```

```text
es
```

--------------------------------

### Translate Text via Managed API

Source: https://docs.libretranslate.com/

Perform a translation request using an API key on the managed LibreTranslate service.

```bash
$ curl -X POST https://libretranslate.com/translate -d q="Hello" -d source=en -d target=es -d api_key=xxxxx
```

```json
{"translatedText":"Hola"}
```

--------------------------------

### Retrieve Alternative Translations with JavaScript

Source: https://docs.libretranslate.com/guides/api_usage

Requests multiple translation variations by specifying the alternatives parameter.

```javascript
const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: "Hello",
    source: "en",
    target: "it",
    format: "text",
    alternatives: 3,
    api_key: "xxxxxx"
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
```

```json
{
    "alternatives": [
        "Salve",
        "Pronto"
    ],
    "translatedText": "Ciao"
}
```

--------------------------------

### Translate HTML Markup with JavaScript

Source: https://docs.libretranslate.com/guides/api_usage

Translates content while preserving HTML tags by setting the format parameter to 'html'.

```javascript
const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: '<p class="green">Hello!</p>',
    source: "en",
    target: "es",
    format: "html",
    api_key: "xxxxxx"
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
```

```json
{
    "translatedText": "<p class=\"green\">¡Hola!</p>"
}
```

--------------------------------

### Apache2 reverse proxy configuration

Source: https://docs.libretranslate.com/guides/faq

Configure Apache2 to redirect HTTP to HTTPS and proxy requests to the local LibreTranslate instance.

```apache
#Libretranslate


#Redirect http to https
<VirtualHost *:80>
    ServerName http://[YOUR_DOMAIN]
    Redirect / https://[YOUR_DOMAIN]
    # ErrorLog ${APACHE_LOG_DIR}/error.log
    # CustomLog ${APACHE_LOG_DIR}/tr-access.log combined
 </VirtualHost>


#https
<VirtualHost *:443>
    ServerName https://[YOUR_DOMAIN]


    ProxyPass / http://127.0.0.1:5000/
    ProxyPassReverse / http://127.0.0.1:5000/
    ProxyPreserveHost On


    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/[YOUR_DOMAIN]/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/[YOUR_DOMAIN]/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/[YOUR_DOMAIN]/fullchain.pem


    # ErrorLog ${APACHE_LOG_DIR}/tr-error.log
    # CustomLog ${APACHE_LOG_DIR}/tr-access.log combined
</VirtualHost>
```

--------------------------------

### Remove API Key

Source: https://docs.libretranslate.com/guides/manage_api_keys

Command to delete an existing API key.

```bash
ltmanage keys remove <api-key>
```

--------------------------------

### POST /translate_file

Source: https://docs.libretranslate.com/api/operations/translate_file

Translates an uploaded file from a source language to a target language.

```APIDOC
## POST /translate_file

### Description
Translates a provided file from a source language to a target language.

### Method
POST

### Endpoint
/translate_file

### Parameters
#### FormData Parameters
- **file** (file) - Required - File to translate
- **source** (string) - Required - Source language code or "auto" for auto detection
- **target** (string) - Required - Target language code
- **api_key** (string) - Optional - API key

### Response
#### Success Response (200)
- **translatedFileUrl** (string) - Translated file url

#### Error Responses
- **400** - Invalid request
- **403** - Banned
- **429** - Slow down
- **500** - Translation error
```

--------------------------------

### Update language review status

Source: https://docs.libretranslate.com/guides/contributing

Modify the meta.json file to mark a language as reviewed by setting the reviewed property to true.

```json
{
 "name": "<Language>",
 "reviewed": true <-- Change this from false to true
}
```

--------------------------------

### Auto-detect Source Language with JavaScript

Source: https://docs.libretranslate.com/guides/api_usage

Automatically identifies the source language by setting the source parameter to 'auto'.

```javascript
const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: "Bonjour!",
    source: "auto",
    target: "en",
    api_key: "xxxxxx"
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
```

```json
{
    "detectedLanguage": {
        "confidence": 90.0,
        "language": "fr"
    },
    "translatedText": "Hello!"
}
```

--------------------------------

### POST /translate

Source: https://docs.libretranslate.com/api/operations/translate

Translates the provided text or array of texts into the specified target language.

```APIDOC
## POST /translate

### Description
Translates input text or an array of strings into a target language. Supports auto-detection of the source language and optional HTML formatting.

### Method
POST

### Endpoint
/translate

### Parameters
#### FormData Parameters
- **q** (string|array) - Required - Text(s) to translate
- **source** (string) - Required - Source language code or "auto" for auto detection
- **target** (string) - Required - Target language code
- **format** (string) - Optional - Format of source text: "text" (default) or "html"
- **alternatives** (integer) - Optional - Preferred number of alternative translations
- **api_key** (string) - Optional - API key

### Response
#### Success Response (200)
- **alternatives** (Array<string>|Array<Array<string>>) - Alternative translations
- **detectedLanguage** (object|Array<object>) - Detected language information including confidence and language code
- **translatedText** (string|array) - The translated text result

#### Error Responses
- **400** - Invalid request
- **403** - Banned
- **429** - Slow down
- **500** - Translation error
```

--------------------------------

### Detect Language with JavaScript

Source: https://docs.libretranslate.com/guides/api_usage

Identifies the language of the provided text using the /detect endpoint.

```javascript
const res = await fetch("https://libretranslate.com/detect", {
  method: "POST",
  body: JSON.stringify({
    q: "Bonjour!",
  }),
  headers: { "Content-Type": "application/json" },
});


console.log(await res.json());
```

```json
[{
    "confidence": 90.0,
    "language": "fr"
}]
```

--------------------------------

### Health Check Response Status

Source: https://docs.libretranslate.com/api/operations/health

The response body returned by the /health endpoint when the service is healthy.

```text
ok
```
Tokens:
Raw