# Utilisation de l'API
Les exemples ci-dessous utilisent Javascript, mais vous pouvez utiliser n'importe quel langage de programmation. Des [bindings](#bindings-de-langage) pour de nombreux langages de programmation sont également disponibles.
### Traduction simple {#traduction-simple}
Requête :
```javascript
const res = await fetch("https://libretranslate.com/translate", {
method: "POST",
body: JSON.stringify({
q: "Hello!",
source: "en",
target: "es",
api_key: "xxxxxx" // peut être optionnel avec l'auto-hébergé
}),
headers: { "Content-Type": "application/json" },
});
console.log(await res.json());
```
Réponse :
```javascript
{
"translatedText": "¡Hola!"
}
```
> [!NOTE]
> Le paramètre `api_key` n'est requis que lors de l'utilisation d'une instance configurée avec des clés API, telle que [libretranslate.com](https://libretranslate.com). Les instances auto-hébergées ne le nécessitent pas.
### Détection automatique de la langue source {#détection-automatique-de-la-langue-source}
Requête :
```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());
```
Réponse :
```javascript
{
"detectedLanguage": {
"confidence": 90.0,
"language": "fr"
},
"translatedText": "Hello!"
}
```
### Traduire du HTML/balisage {#traduire-du-htmlbalisage}
Requête :
```javascript
const res = await fetch("https://libretranslate.com/translate", {
method: "POST",
body: JSON.stringify({
q: 'Hello!
',
source: "en",
target: "es",
format: "html",
api_key: "xxxxxx"
}),
headers: { "Content-Type": "application/json" },
});
console.log(await res.json());
```
Réponse :
```javascript
{
"translatedText": "¡Hola!
"
}
```
### Traductions alternatives {#traductions-alternatives}
Requête :
```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());
```
Réponse :
```javascript
{
"alternatives": [
"Salve",
"Pronto"
],
"translatedText": "Ciao"
}
```
### Détection de langue {#détection-de-langue}
Requête :
```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());
```
Réponse :
```javascript
[{
"confidence": 90.0,
"language": "fr"
}]
```
### Langues supportées {#langues-supportées}
https://libretranslate.com/languages
## Bindings de langage {#bindings-de-langage}
Vous pouvez utiliser l'API LibreTranslate en utilisant les bindings suivants :
- Rust :
- Node.js :
- TypeScript :
- .Net :
- Go :
- Python :
- PHP :
- C++ :
- Swift :
- Unix :
- Shell :
- Java :
- Ruby :
- R :