# Langues

> amodb sert 14 langues de base : en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it et es. Passez une balise de style TMDB comme ru-RU, pt-BR ou zh-CN dans language ; amodb en lit la langue de base. Toute autre langue se replie sur l'anglais : aucune requête n'échoue à cause de sa balise.

## Les 14 langues

| 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`     |

## Comment fonctionne le paramètre

Ajoutez `language` à tout appel de style TMDB. amodb accepte les formes de balise qu'envoient les clients TMDB :

- `ru-RU`, `pt-BR` et `zh-CN`, avec une région
- `ru` et `pt`, sans région
- `pt_BR`, avec un tiret bas

amodb prend la partie avant le premier `-` ou `_`, la met en minuscules et sert cette langue si elle fait partie des 14. Tout le reste renvoie l'anglais. Le cache de périphérie stocke chaque langue de base une seule fois : `ru` et `ru-RU` partagent donc une même entrée de cache.

```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,
)
```

## Ce qui est traduit

Les champs traduits suivent TMDB : `title` et `overview` pour les films, `name` et `overview` pour les séries, les saisons et les épisodes, `tagline`, les noms de genres et les biographies des personnes. Les champs sans traduction dans une langue reviennent comme dans TMDB, souvent sous forme de chaîne vide : gardez donc une requête en anglais comme repli pour l'affichage.

## L'hébreu et le texte de droite à gauche

Le texte hébreu arrive en Unicode brut. Définissez `dir="rtl"` ou `dir="auto"` sur l'élément qui l'affiche ; l'API n'ajoute pas de marques de direction.

## Questions et réponses

### pt-PT renvoie-t-il un texte différent de pt-BR ?

Non. amodb ne lit que la langue de base : pt-PT et pt-BR renvoient donc tous deux du portugais. Il en va de même pour zh-CN et zh-TW, qui renvoient tous deux du chinois.

### Que se passe-t-il avec une langue hors des 14 ?

L'appel réussit et renvoie l'anglais. Par exemple, language=de-DE renvoie le titre et le résumé en anglais.

## Pages liées

- [Images](https://amodb.dev/fr/images/): Chargez affiches, fonds et photos de profil depuis img.amodb.dev, avec les chemins et tailles TMDB de w92 à original. Sans clé, cache de 30 jours.
- [Démarrage rapide](https://amodb.dev/fr/quickstart/): Faites votre premier appel amodb : obtenez une clé, demandez un film en curl, JavaScript, Python, PHP ou Go, puis chargez l'affiche. En moins de 2 minutes.
- [Erreurs](https://amodb.dev/fr/errors/): Chaque erreur amodb : statut HTTP, status_code et message TMDB, plus la forme d'erreur OMDb. Ce que chacune signifie et ce que votre client doit faire.

Mis à jour: 2026-10-18. Source: https://amodb.dev/fr/languages/