# TMDB API 密钥：约一分钟拿到兼容密钥

> 要为商业项目获取 TMDB API 密钥，请用邮箱和一次性验证码登录 amodb，购买套餐并创建密钥，整个过程约一分钟。密钥采用 TMDB v3 的格式，所以你只需更换基础 URL，代码保持不变。amodb 没有免费额度。

## 分四步获取兼容 TMDB 的密钥

amodb 出售的是它自己 API 的密钥，该 API 保留了 TMDB v3 的路径和 JSON。它不是 TMDB 的密钥，也不能用于 api.themoviedb.org。你得到的是形式相同的密钥，即 32 位小写十六进制字符，你的 TMDB 客户端只需更换一次基础 URL 就能接受它。

1. 打开[定价页](https://amodb.dev/zh/pricing/)，选择一个套餐：每分钟 20、40 或 120 个请求。每个套餐都返回全部数据。
2. 用邮箱登录。amodb 会发送一个 6 位验证码，有效期 10 分钟。没有密码。
3. 用银行卡、Apple Pay 或 Google Pay 付款，可预付 1 至 24 个月。不会自动续费。
4. 打开 **账户**，再打开 **API 密钥**，创建一个密钥。请立即复制，因为完整密钥只显示一次。

整个过程约需一分钟，付款确认后密钥立即可用。

## 使用密钥：更换基础 URL

保留你的 TMDB 代码，只更换两个值：基础 URL 和密钥。两种发送密钥的方式都可用：查询中的 `api_key` 和 `Authorization: Bearer` 请求头。

```bash
# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"
```

用 Bearer 请求头发出的同一个调用，分别用三种语言演示：

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])
```

响应采用 TMDB v3 的格式：

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

从 `/3/configuration` 读取 `images.secure_base_url`，这样海报链接就会指向 `img.amodb.dev`。图片无需密钥。关于如何发送密钥，见[认证](https://amodb.dev/zh/authentication/)，更完整的步骤见[快速开始](https://amodb.dev/zh/quickstart/)。

## 免费 TMDB 密钥与 amodb 密钥对比

正确的选择取决于你的项目和你的条款，而不是功能清单。TMDB 一列只重复 TMDB 公开发布的一般信息。当前规则请阅读 TMDB 自己的条款和文档。

|        | 免费 TMDB 密钥                     | amodb 密钥                                                                                         |
| ------ | ------------------------------ | ------------------------------------------------------------------------------------------------ |
| 价格     | 符合条件的使用按 TMDB 条款免费             | 付费，预付 1 至 24 个月，无试用                                                                              |
| 获取方式   | 在 TMDB 网站注册 TMDB 账户并申请密钥       | 邮箱、6 位验证码、付款，然后在账户中创建密钥                                                                          |
| 商业使用   | 商业使用和署名要求请查看 TMDB 的条款          | 按 amodb 的条款允许                                                                                    |
| 速率限制   | 由 TMDB 设定，请查阅其文档               | 按套餐每分钟 20、40 或 120 个请求                                                                           |
| 数据     | TMDB 数据                        | TMDB v3 格式，另可通过 `append_to_response` 获取 `ratings`、`moods`、`soundtracks`、`wikidata` 和 `showtimes` |
| 密钥格式   | v3 密钥，32 位十六进制字符               | 32 位小写十六进制字符                                                                                     |
| 基础 URL | `https://api.themoviedb.org/3` | `https://api.amodb.dev/3`                                                                        |
| 写入方法   | 账户、列表和评分方法                     | 不提供，返回 405                                                                                       |

## 什么时候免费 TMDB 密钥就够了

如果是符合 TMDB 条款的个人或学习项目，就继续使用免费的 TMDB 密钥。只要你的使用符合条件，TMDB 不花一分钱，这一点 amodb 无法比拟。

当项目属于商业性质而你想要一份付费协议，当你需要可据以规划的每分钟固定限制，或者希望一个作品页通过一次调用获得五个来源的评分时，请使用 amodb 密钥。请先检查缺口：写入方法、变更动态和少数其他路径不提供。它们列在 [TMDB API 替代方案](https://amodb.dev/zh/tmdb-api-alternative/)和 [amodb 与 TMDB 对比](https://amodb.dev/zh/amodb-vs-tmdb/)中。

## 商业使用与限制

按 amodb 的[服务条款](https://amodb.dev/zh/terms/)允许商业使用。你可以在应用、网站、机器人和内部工具中展示数据，也可以缓存响应以节省请求。你不得转售原始 API 访问、发布 API 响应的批量副本、共享密钥，或开设额外账户来提高速率。完整列表见[可接受使用政策](https://amodb.dev/zh/acceptable-use/)。

套餐决定速率。每个响应都带有 `X-RateLimit-Limit`、`X-RateLimit-Remaining` 和 `X-RateLimit-Reset`，429 还会加上 `Retry-After`。详情见[速率限制](https://amodb.dev/zh/rate-limits/)。

## 常见问题

### 这是 TMDB API 密钥吗？

不是。这是 amodb 密钥。它与 TMDB v3 密钥的形式相同，都是 32 位小写十六进制字符，可用于 amodb 兼容 TMDB v3 的路径 https://api.amodb.dev/3。它不能用于 api.themoviedb.org，amodb 是独立的服务。

### 能免费获得 TMDB API 密钥吗？

TMDB 按其自身条款为符合条件的使用提供免费密钥，需要到 TMDB 网站申请。amodb 没有免费额度，也没有试用，所以 amodb 密钥始终附带付费套餐。请先阅读 TMDB 的条款，再决定哪一种适合你。

### 不注册就能获得 TMDB API 密钥吗？

在 amodb 上不行。你用邮箱和 6 位验证码登录，没有密码，也没有申请表，然后付款并创建密钥。TMDB 密钥需要 TMDB 账户，当前步骤请查看 TMDB 网站。

### 可以在商业项目中使用这个密钥吗？

可以。按 amodb 的条款允许商业使用。你可以在自己的应用和网站中使用这些数据，但不得转售原始 API 访问、共享密钥，也不要把密钥放进客户端代码。

### 一个密钥可以发出多少请求？

套餐决定速率：每个密钥每分钟 20、40 或 120 个请求，按滑动 60 秒窗口统计。每个套餐都返回全部数据，没有每日上限。

## 相关页面

- [TMDB API 替代方案](https://amodb.dev/zh/tmdb-api-alternative/): 在找 TMDB API 替代方案？对比条款、限制、语言和评分，再迁移到保留大多数 TMDB v3 读取路径和 JSON 的付费 API，并了解缺口。
- [快速开始](https://amodb.dev/zh/quickstart/): 发出第一次 amodb 调用：获取密钥，用 curl、JavaScript、Python、PHP 或 Go 请求电影详情，再加载海报。
- [定价](https://amodb.dev/zh/pricing/): amodb 套餐的区别只在每分钟请求数：20、40 或 120。所有套餐都包含全部兼容 TMDB v3 和 OMDb 的数据。预付，不续费，无试用。
- [认证](https://amodb.dev/zh/authentication/): 如何发送 amodb 密钥：查询中的 api_key、Bearer 请求头，或 OMDb 的 apikey。含密钥格式、保管和 401 错误。
- [amodb 与 TMDB 对比](https://amodb.dev/zh/amodb-vs-tmdb/): amodb 与 TMDB 正面对比：接口兼容程度、amodb 未提供的路径、免费与付费条款、14 种语言、扩展功能和速率限制。
- [速率限制](https://amodb.dev/zh/rate-limits/): amodb 按滑动 60 秒窗口内每分钟请求数限制每个密钥：按套餐为 20、40 或 120。读取速率限制响应头，并用 Retry-After 处理 429。

更新于: 2026-10-19. Source: https://amodb.dev/zh/tmdb-api-key/