# 语言

> amodb 支持 14 种基础语言：en、ru、uk、be、zh、pt、bg、he、cs、ro、fr、pl、it 和 es。在 language 参数中传入 ru-RU 这样的 TMDB 风格标签，其他语言回退到英语，请求不会因标签而失败。

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

## 参数如何工作

在任何 TMDB 风格的调用上添加 `language`。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/zh/images/): 从 img.amodb.dev 加载海报、背景图和人物照片，路径和尺寸与 TMDB 相同，从 w92 到 original。无需密钥，缓存 30 天。
- [快速开始](https://amodb.dev/zh/quickstart/): 发出第一次 amodb 调用：获取密钥，用 curl、JavaScript、Python、PHP 或 Go 请求电影详情，再加载海报。
- [错误](https://amodb.dev/zh/errors/): amodb 的每个错误及其 HTTP 状态、TMDB status_code 和消息，以及 OMDb 错误结构。每个错误的含义和客户端下一步该做什么。

更新于: 2026-10-18. Source: https://amodb.dev/zh/languages/