获取 API 密钥

API 参考

本索引列出 amodb 的每个接口。每页给出兼容 TMDB v3 或 OMDb 的路径、查询参数、五种语言的请求示例和真实的 JSON 响应。所有接口共用一个密钥，可通过 api_key、Bearer 请求头或 apikey 传入。

电影

  • 电影详情 API

    /3/movie/{movie_id}

    路径和 JSON 与 TMDB v3 相同的电影详情 API：按 ID 取电影，用 append_to_response 加入演职员和评分，支持 14 种语言。

  • 演职员 API

    /3/movie/{movie_id}/credits

    与 TMDB v3 路径和 JSON 相同的演职员 API。获取电影、剧集、季和集的演员与幕后人员，含 order、department 和 job 字段。

  • 图片 API 与图片主机

    /3/movie/{movie_id}/images

    采用 TMDB v3 路径的电影图片 API：列出作品的海报、背景图、标志和剧照，再从 img.amodb.dev 以 10 种尺寸无密钥加载。

  • 视频与预告片 API

    /3/movie/{movie_id}/videos

    兼容 TMDB v3 路径的电影视频 API：列出电影或剧集的预告片、先导预告、片段和花絮，再在你的代码里按类型和语言筛选。

  • 翻译 API

    /3/movie/{movie_id}/translations

    兼容 TMDB v3 路径的翻译 API：一次读取电影、剧集或单集以所有语言存储的标题、简介和宣传语，无需逐个语言请求。

  • 关键词 API

    /3/movie/{movie_id}/keywords

    采用 TMDB v3 路径的关键词 API：列出电影或剧集的情节标签、查询关键词及其电影，并把 ID 用于 discover 的 with_keywords。

电视剧

  • 电视剧 API

    /3/tv/{series_id}

    路径和 JSON 与 TMDB v3 相同的电视剧 API。按 ID 获取剧集的季、电视网和下一集，以及内容分级和观看平台。

  • 电视剧季与单集 API

    /3/tv/{series_id}/season/{season_number}

    路径和 JSON 与 TMDB v3 相同的电视剧季与单集 API。读取一季及其全部单集，或读取单集的播出日期、时长和剧照。

人物

  • 人物详情 API

    /3/person/{person_id}

    路径和 JSON 与 TMDB v3 相同的人物详情 API。按 ID 获取演员或幕后人员，含传记、作品列表、外部 ID 和热门列表。

搜索和列表

  • 搜索 API

    /3/search/movie

    路径和 JSON 与 TMDB v3 相同的搜索 API。按文本查找电影、电视剧、人物、系列合集、公司和关键词，支持年份筛选和分页。

  • 发现 API

    /3/discover/movie

    与 TMDB v3 筛选条件相同的 discover API。按类型、演员、公司、关键词、年份、评分、时长和平台列出电影和剧集，并可排序。

  • 热门与榜单接口

    /3/trending/{media_type}/{time_window}

    兼容 TMDB v3 路径的热门电影 API：日榜与周榜，以及电影和电视剧的正在上映、热门、高分、即将上映榜单，缓存 30 分钟。

  • 类型与查找列表

    /3/genre/movie/list

    采用 TMDB v3 路径的类型列表 API：带译名的电影和电视剧类型 ID，以及国家、语言、职务、年龄分级和流媒体平台列表。

  • 系列合集 API

    /3/collection/{collection_id}

    采用 TMDB v3 路径的系列合集 API：按 ID 获取系列及全部成员影片，读取电影的 belongs_to_collection，并按名称搜索合集。

  • 公司与电视网

    /3/company/{company_id}

    按 TMDB v3 路径查询制作公司和电视网：按 ID 读取名称、国家和标志，再按公司或电视网 ID 筛选 discover。

  • 按外部 ID 查找

    /3/find/{external_id}

    用 TMDB find 接口按 IMDb、TVDB、Wikidata 或 Kinopoisk ID 查找电影、剧集或人物，并读取外部 ID。

amodb 扩展

  • 电影与电视剧评分

    /3/movie/{movie_id}/ratings

    一次调用返回作品的 IMDb、Kinopoisk、Metacritic、Rotten Tomatoes 和 TMDB 评分，来源未知时为 null。

  • 情绪指数

    /3/movie/{movie_id}/moods

    电影情绪 API，每部作品提供 0 到 10 的情绪指数。读取电影或剧集的情绪，用 append_to_response=moods 合并，构建徽章或筛选。

  • 原声配乐

    /3/movie/{movie_id}/soundtracks

    返回电影或电视剧原声专辑及曲目列表的 API。可直接调用该接口，或添加 append_to_response=soundtracks。

  • 影院放映时间

    /3/movie/{movie_id}/showtimes

    返回某国家某部电影的影院和放映时间的 API，也可只取国家汇总。可并入详情调用，或与 now_playing 搭配使用。

OMDb 风格

  • OMDb 兼容接口

    /omdb/

    位于 api.amodb.dev/omdb/ 的 OMDb 兼容接口。用 i 或 t 查找，用 s 搜索，读取 Ratings 数组，只需更换基础 URL。