# Uso de la API
Los siguientes ejemplos usan Javascript, pero puedes usar cualquier lenguaje de programación. También hay [enlaces de lenguaje](#language-bindings) disponibles para muchos lenguajes de programación.
### Traducción Simple {#traducción-simple}
Solicitud:
```javascript
const res = await fetch("https://libretranslate.com/translate", {
method: "POST",
body: JSON.stringify({
q: "Hello!",
source: "en",
target: "es",
api_key: "xxxxxx" // puede ser opcional si lo alojas tú mismo
}),
headers: { "Content-Type": "application/json" },
});
console.log(await res.json());
```
Respuesta:
```javascript
{
"translatedText": "¡Hola!"
}
```
> [!NOTE]
> El parámetro `api_key` solo es necesario cuando se utiliza una instancia configurada con claves API, como [libretranslate.com](https://libretranslate.com). Las instancias que alojas tú mismo no lo requieren.
### Detección Automática del Idioma de Origen {#detección-automática-del-idioma-de-origen}
Solicitud:
```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());
```
Respuesta:
```javascript
{
"detectedLanguage": {
"confidence": 90.0,
"language": "fr"
},
"translatedText": "Hello!"
}
```
### Traducir HTML/Marcado {#traducir-htmlmarcado}
Solicitud:
```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());
```
Respuesta:
```javascript
{
"translatedText": "¡Hola!
"
}
```
### Traducciones Alternativas {#traducciones-alternativas}
Solicitud:
```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());
```
Respuesta:
```javascript
{
"alternatives": [
"Salve",
"Pronto"
],
"translatedText": "Ciao"
}
```
### Detección de Idioma {#detección-de-idioma}
Solicitud:
```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());
```
Respuesta:
```javascript
[{
"confidence": 90.0,
"language": "fr"
}]
```
### Idiomas Soportados {#idiomas-soportados}
https://libretranslate.com/languages
## Enlaces de Lenguaje {#enlaces-de-lenguaje}
Puedes usar la API de LibreTranslate con los siguientes enlaces:
- Rust:
- Node.js:
- TypeScript:
- .Net:
- Go:
- Python:
- PHP:
- C++:
- Swift:
- Unix:
- Shell:
- Java:
- Ruby:
- R: