# Мови

> amodb обслуговує 14 базових мов: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it та es. Передайте тег у стилі TMDB, наприклад ru-RU, pt-BR або zh-CN, у параметрі language. 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. Усе інше повертає англійську. Кеш на периферії зберігає кожну базову мову один раз, тож `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/uk/images/): Завантажуйте постери, фони й фото профілів з img.amodb.dev зі шляхами та розмірами TMDB від w92 до original. Без ключа, кеш 30 днів, один шаблон URL.
- [Швидкий старт](https://amodb.dev/uk/quickstart/): Перший виклик amodb: отримайте ключ, запросіть деталі фільму в curl, JavaScript, Python, PHP чи Go і завантажте постер з img.amodb.dev. Менш ніж за 2 хвилини.
- [Помилки](https://amodb.dev/uk/errors/): Усі помилки amodb зі статусом HTTP, status_code і повідомленням TMDB, а також форма помилки OMDb. Що означає кожна й що має робити ваш клієнт далі.

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