分四步获取兼容 TMDB 的密钥

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

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

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

使用密钥:更换基础 URL

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

Shell
# 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 请求头发出的同一个调用,分别用三种语言演示:

bashjspy
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 的格式:

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。图片无需密钥。关于如何发送密钥,见认证,更完整的步骤见快速开始。

免费 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 位小写十六进制字符
基础 URLhttps://api.themoviedb.org/3https://api.amodb.dev/3
写入方法账户、列表和评分方法不提供,返回 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。详情见速率限制。