# Idiomas

> O amodb serve 14 idiomas base: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it e es. Passe uma tag no estilo TMDB como ru-RU, pt-BR ou zh-CN no parâmetro language. O amodb lê o idioma base da tag. Qualquer outro idioma volta para o inglês, então uma requisição nunca falha por causa da tag.

## Os 14 idiomas

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

## Como o parâmetro funciona

Adicione `language` a qualquer chamada no estilo TMDB. O amodb aceita as formas de tag que os clientes TMDB enviam:

- `ru-RU`, `pt-BR` e `zh-CN`, com região
- `ru` e `pt`, sem região
- `pt_BR`, com sublinhado

O amodb pega a parte antes do primeiro `-` ou `_`, converte para minúsculas e serve esse idioma quando ele é um dos 14. Qualquer outra coisa retorna inglês. O cache de borda guarda cada idioma base uma só vez, então `ru` e `ru-RU` compartilham uma entrada 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,
)
```

## O que é traduzido

Os campos traduzidos seguem o TMDB: `title` e `overview` para filmes, `name` e `overview` para séries, temporadas e episódios, `tagline`, nomes de gêneros e biografias de pessoas. Os campos sem tradução em um idioma voltam como no TMDB, muitas vezes como uma string vazia, então mantenha uma requisição em inglês como fallback para exibição.

## Hebraico e texto da direita para a esquerda

O texto em hebraico volta como Unicode simples. Defina `dir="rtl"` ou `dir="auto"` no elemento que o exibe; a API não adiciona marcas de direção.

## Perguntas e respostas

### pt-PT retorna um texto diferente de pt-BR?

Não. O amodb lê apenas o idioma base, então pt-PT e pt-BR retornam português. O mesmo vale para zh-CN e zh-TW, que retornam chinês.

### O que acontece com um idioma fora dos 14?

A chamada tem sucesso e retorna inglês. Por exemplo, language=de-DE retorna o título e a sinopse em inglês.

## Páginas relacionadas

- [Imagens](https://amodb.dev/pt/images/): Pôsteres, backdrops e fotos de perfil em img.amodb.dev com caminhos e tamanhos do TMDB, de w92 a original. Sem chave, cache de 30 dias e um só padrão de URL.
- [Início rápido](https://amodb.dev/pt/quickstart/): Faça sua primeira chamada ao amodb: obtenha uma chave, peça um filme em curl, JavaScript, Python, PHP ou Go e carregue o pôster. Menos de 2 minutos.
- [Erros](https://amodb.dev/pt/errors/): Todos os erros do amodb com status HTTP, status_code e mensagem do TMDB, mais o formato de erro do OMDb. O que cada um significa e o que seu cliente deve fazer.

Atualizado: 2026-10-18. Source: https://amodb.dev/pt/languages/