# Езици

> 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-те. Всичко друго връща английски. Кешът в 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/bg/images/): Зареждайте постери, фонови изображения и снимки от img.amodb.dev с пътищата и размерите на TMDB, от w92 до original. Без ключ, кеш 30 дни, един шаблон на URL.
- [Бърз старт](https://amodb.dev/bg/quickstart/): Първата ви заявка към amodb: вземете ключ, поискайте детайли за филм с curl, JavaScript, Python, PHP или Go и заредете постера от img.amodb.dev. До 2 минути.
- [Грешки](https://amodb.dev/bg/errors/): Всяка грешка на amodb с HTTP статус, status_code на TMDB и съобщение, плюс формата на грешките на OMDb. Какво означава всяка и какво да направи клиентът ви.

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