# Lingue

> amodb serve 14 lingue di base: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it ed es. Passa un tag in stile TMDB come ru-RU, pt-BR o zh-CN nel parametro language. amodb legge la lingua di base dal tag. Qualsiasi altra lingua ripiega sull'inglese, quindi una richiesta non fallisce mai a causa del tag.

## Le 14 lingue

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

## Come funziona il parametro

Aggiungi `language` a qualsiasi chiamata in stile TMDB. amodb accetta le forme di tag che inviano i client TMDB:

- `ru-RU`, `pt-BR` e `zh-CN`, con una regione
- `ru` e `pt`, senza regione
- `pt_BR`, con un trattino basso

amodb prende la parte prima del primo `-` o `_`, la converte in minuscolo e serve quella lingua se è una delle 14. Qualsiasi altra cosa restituisce l'inglese. La cache edge memorizza ogni lingua di base una sola volta, quindi `ru` e `ru-RU` condividono una sola voce di 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,
)
```

## Cosa viene tradotto

I campi tradotti seguono TMDB: `title` e `overview` per i film, `name` e `overview` per serie, stagioni ed episodi, `tagline`, i nomi dei generi e le biografie delle persone. I campi senza traduzione in una lingua tornano come in TMDB, spesso come stringa vuota, quindi tieni una richiesta in inglese come ripiego per la visualizzazione.

## Ebraico e testo da destra a sinistra

Il testo ebraico arriva come semplice Unicode. Imposta `dir="rtl"` o `dir="auto"` sull'elemento che lo mostra; l'API non aggiunge segni di direzione.

## Domande e risposte

### pt-PT restituisce un testo diverso da pt-BR?

No. amodb legge solo la lingua di base, quindi pt-PT e pt-BR restituiscono entrambi il portoghese. Lo stesso vale per zh-CN e zh-TW, che restituiscono entrambi il cinese.

### Cosa succede con una lingua fuori dalle 14?

La chiamata riesce e restituisce l'inglese. Per esempio, language=de-DE restituisce il titolo e la trama in inglese.

## Pagine correlate

- [Immagini](https://amodb.dev/it/images/): Carica locandine, sfondi e foto dei profili da img.amodb.dev con percorsi e dimensioni TMDB da w92 a original. Nessuna chiave, cache di 30 giorni, uno schema.
- [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti.
- [Errori](https://amodb.dev/it/errors/): Ogni errore di amodb con stato HTTP, status_code e messaggio TMDB, più la forma dell'errore OMDb. Cosa significa ciascuno e cosa deve fare il tuo client.

Aggiornato: 2026-10-18. Source: https://amodb.dev/it/languages/