分四步获取兼容 TMDB 的密钥
amodb 出售的是它自己 API 的密钥,该 API 保留了 TMDB v3 的路径和 JSON。它不是 TMDB 的密钥,也不能用于 api.themoviedb.org。你得到的是形式相同的密钥,即 32 位小写十六进制字符,你的 TMDB 客户端只需更换一次基础 URL 就能接受它。
- 打开定价页,选择一个套餐:每分钟 20、40 或 120 个请求。每个套餐都返回全部数据。
- 用邮箱登录。amodb 会发送一个 6 位验证码,有效期 10 分钟。没有密码。
- 用银行卡、Apple Pay 或 Google Pay 付款,可预付 1 至 24 个月。不会自动续费。
- 打开 账户,再打开 API 密钥,创建一个密钥。请立即复制,因为完整密钥只显示一次。
整个过程约需一分钟,付款确认后密钥立即可用。
使用密钥:更换基础 URL
保留你的 TMDB 代码,只更换两个值:基础 URL 和密钥。两种发送密钥的方式都可用:查询中的 api_key 和 Authorization: Bearer 请求头。
# 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 请求头发出的同一个调用,分别用三种语言演示:
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
-H "Authorization: Bearer $AMODB_KEY"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);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 的格式:
{
"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。图片无需密钥。关于如何发送密钥,见认证,更完整的步骤见快速开始。
免费 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:/ | https:/ |
| 写入方法 | 账户、列表和评分方法 | 不提供,返回 405 |
什么时候免费 TMDB 密钥就够了
如果是符合 TMDB 条款的个人或学习项目,就继续使用免费的 TMDB 密钥。只要你的使用符合条件,TMDB 不花一分钱,这一点 amodb 无法比拟。
当项目属于商业性质而你想要一份付费协议,当你需要可据以规划的每分钟固定限制,或者希望一个作品页通过一次调用获得五个来源的评分时,请使用 amodb 密钥。请先检查缺口:写入方法、变更动态和少数其他路径不提供。它们列在 TMDB API 替代方案和 amodb 与 TMDB 对比中。
商业使用与限制
按 amodb 的服务条款允许商业使用。你可以在应用、网站、机器人和内部工具中展示数据,也可以缓存响应以节省请求。你不得转售原始 API 访问、发布 API 响应的批量副本、共享密钥,或开设额外账户来提高速率。完整列表见可接受使用政策。
套餐决定速率。每个响应都带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset,429 还会加上 Retry-After。详情见速率限制。