# Языки

> amodb поддерживает 14 базовых языков: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it и es. Передавайте в параметре language тег в стиле TMDB, например ru-RU, pt-BR или zh-CN. amodb берет из тега базовый язык. Любой другой язык откатывается на английский, поэтому запрос никогда не падает из-за тега.

## 14 языков

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

## Как работает параметр

Добавьте `language` к любому вызову в стиле TMDB. amodb принимает формы тега, которые отправляют клиенты TMDB:

- `ru-RU`, `pt-BR` и `zh-CN`, с регионом
- `ru` и `pt`, без региона
- `pt_BR`, с подчеркиванием

amodb берет часть до первого `-` или `_`, приводит ее к нижнему регистру и отдает этот язык, если он один из 14. Любой другой язык возвращает английский. Кэш edge хранит каждый базовый язык один раз, поэтому `ru` и `ru-RU` используют одну запись кэша.

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

## Что переводится

Переводятся те же поля, что и в TMDB: `title` и `overview` для фильмов, `name` и `overview` для сериалов, сезонов и серий, `tagline`, названия жанров и биографии людей. Поля без перевода на выбранном языке возвращаются так же, как в TMDB, часто пустой строкой, поэтому держите запрос на английском как запасной вариант для показа.

## Иврит и текст справа налево

Текст на иврите приходит как обычный Unicode. Задайте `dir="rtl"` или `dir="auto"` у элемента, который его показывает; API не добавляет маркеры направления.

## Вопросы и ответы

### Возвращает ли pt-PT другой текст, чем pt-BR?

Нет. amodb читает только базовый язык, поэтому pt-PT и pt-BR оба возвращают португальский. То же относится к zh-CN и zh-TW: оба возвращают китайский.

### Что будет с языком вне этих 14?

Вызов проходит успешно и возвращает английский. Например, language=de-DE вернет английское название и описание.

## Связанные страницы

- [Изображения](https://amodb.dev/ru/images/): Загружайте постеры, фоны и фото людей с img.amodb.dev по путям и размерам TMDB от w92 до original. Без ключа, кэш на 30 дней, один шаблон URL для всех.
- [Быстрый старт](https://amodb.dev/ru/quickstart/): Первый вызов amodb: получите ключ, запросите детали фильма через curl, JavaScript, Python, PHP или Go и загрузите постер с img.amodb.dev. Меньше 2 минут.
- [Ошибки](https://amodb.dev/ru/errors/): Все ошибки amodb: HTTP-статус, status_code и сообщение TMDB, а также формат ошибки OMDb. Что означает каждая и что должен делать ваш клиент дальше.

Обновлено: 2026-10-18. Source: https://amodb.dev/ru/languages/