# Idiomas

> amodb sirve 14 idiomas base: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it y es. Pasa una etiqueta estilo TMDB como ru-RU, pt-BR o zh-CN en el parámetro language. amodb lee el idioma base de la etiqueta. Cualquier otro idioma recurre al inglés, así que una solicitud nunca falla por su etiqueta.

## Los 14 idiomas

| Code | Language   | Native name | Example tag |
| ---- | ---------- | ----------- | ----------- |
| `en` | English    | English     | `en-US`     |
| `ru` | Russian    | Русский     | `ru-RU`     |
| `uk` | Ukrainian  | Українська  | `uk-UA`     |
| `be` | Belarusian | Беларуская  | `be-BY`     |
| `zh` | Chinese    | 中文          | `zh-CN`     |
| `pt` | Portuguese | Português   | `pt-BR`     |
| `bg` | Bulgarian  | Български   | `bg-BG`     |
| `he` | Hebrew     | עברית       | `he-IL`     |
| `cs` | Czech      | Čeština     | `cs-CZ`     |
| `ro` | Romanian   | Română      | `ro-RO`     |
| `fr` | French     | Français    | `fr-FR`     |
| `pl` | Polish     | Polski      | `pl-PL`     |
| `it` | Italian    | Italiano    | `it-IT`     |
| `es` | Spanish    | Español     | `es-ES`     |

## Cómo funciona el parámetro

Añade `language` a cualquier llamada estilo TMDB. amodb acepta las formas de etiqueta que envían los clientes de TMDB:

- `ru-RU`, `pt-BR` y `zh-CN`, con región
- `ru` y `pt`, sin región
- `pt_BR`, con guion bajo

amodb toma la parte anterior al primer `-` o `_`, la pasa a minúsculas y sirve ese idioma si es uno de los 14. Cualquier otra cosa devuelve inglés. La caché perimetral guarda cada idioma base una sola vez, así que `ru` y `ru-RU` comparten una entrada de caché.

```bash
curl "https://api.amodb.dev/3/movie/550?language=uk-UA" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/tv/1396?language=pl-PL", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const show = await res.json();
console.log(show.name, show.overview);
```

```python
res = requests.get(
    "https://api.amodb.dev/3/search/movie",
    params={"query": "Матрица", "language": "ru-RU"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
```

## Qué se traduce

Los campos traducidos siguen a TMDB: `title` y `overview` en películas, `name` y `overview` en series, temporadas y episodios, `tagline`, los nombres de géneros y las biografías de personas. Los campos sin traducción en un idioma llegan como en TMDB, a menudo como una cadena vacía, así que conserva una solicitud en inglés como alternativa para mostrar.

## Hebreo y texto de derecha a izquierda

El texto en hebreo llega como Unicode simple. Define `dir="rtl"` o `dir="auto"` en el elemento que lo muestra; la API no añade marcas de dirección.

## Preguntas y respuestas

### ¿pt-PT devuelve un texto distinto de pt-BR?

No. amodb lee solo el idioma base, así que pt-PT y pt-BR devuelven portugués. Lo mismo vale para zh-CN y zh-TW, que devuelven chino.

### ¿Qué pasa con un idioma fuera de los 14?

La llamada tiene éxito y devuelve inglés. Por ejemplo, language=de-DE devuelve el título y la sinopsis en inglés.

## Páginas relacionadas

- [Imágenes](https://amodb.dev/es/images/): Carga pósteres, backdrops y fotos de perfil desde img.amodb.dev con rutas y tamaños de TMDB, de w92 a original. Sin clave, caché de 30 días y un patrón de URL.
- [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 minutos.
- [Errores](https://amodb.dev/es/errors/): Cada error de amodb con su estado HTTP, su status_code de TMDB y su mensaje, más la forma de error de OMDb. Qué significa cada uno y qué debe hacer tu cliente.

Actualizado: 2026-10-18. Source: https://amodb.dev/es/languages/