获取 API 密钥

演职员 API

演职员接口返回电影的演员和幕后人员（GET /3/movie/{movie_id}/credits），剧集、季、集在 /3/tv 下。JSON 与 TMDB v3 一致，含 credit_id、order、job。单集增加 guest_stars。

更新于 以 Markdown 查看

获取电影演职员

GET /3/movie/{movie_id}/credits 为一部电影返回两个数组：cast 是出镜的人，crew 是幕后工作的人。每一项都带有人物 ID，所以你可以在人物页中打开完整记录。同样的数据也可以通过 append_to_response=credits 包含在电影响应中。

示例读取《盗梦空间》，打印导演并列出署名前五位的演员。

bashjspyphpgo 
curl -sSf "https://api.amodb.dev/3/movie/27205/credits?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const url = 'https://api.amodb.dev/3/movie/27205/credits?language=en-US';
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` } });
if (!res.ok) throw new Error(`amodb returned ${res.status}`);
const credits = await res.json();
const director = credits.crew.find((c) => c.job === 'Director');
console.log('Director:', director?.name);
for (const c of [...credits.cast].sort((a, b) => a.order - b.order).slice(0, 5)) {
  console.log(c.order, c.name, 'as', c.character);
}
import os
import requests

r = requests.get(
    "https://api.amodb.dev/3/movie/27205/credits",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
r.raise_for_status()
credits = r.json()
director = next((c for c in credits["crew"] if c["job"] == "Director"), None)
print("Director:", director and director["name"])
for c in sorted(credits["cast"], key=lambda c: c["order"])[:5]:
    print(c["order"], c["name"], "as", c["character"])
<?php
$url = 'https://api.amodb.dev/3/movie/27205/credits?language=en-US';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException("amodb returned $status");
}
$credits = json_decode($body, true);
usort($credits['cast'], fn ($a, $b) => $a['order'] <=> $b['order']);
foreach (array_slice($credits['cast'], 0, 5) as $c) {
    echo $c['order'], ' ', $c['name'], ' as ', $c['character'], PHP_EOL;
}
package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"
)

type Credits struct {
	Cast []struct {
		Order     int    `json:"order"`
		Name      string `json:"name"`
		Character string `json:"character"`
	} `json:"cast"`
	Crew []struct {
		Name string `json:"name"`
		Job  string `json:"job"`
	} `json:"crew"`
}

func main() {
	req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/27205/credits?language=en-US", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
	client := &http.Client{Timeout: 10 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		panic(res.Status)
	}
	var c Credits
	if err := json.NewDecoder(res.Body).Decode(&c); err != nil {
		panic(err)
	}
	for _, m := range c.Crew {
		if m.Job == "Director" {
			fmt.Println("Director:", m.Name)
		}
	}
	for i, a := range c.Cast {
		if i == 5 {
			break
		}
		fmt.Println(a.Order, a.Name, "as", a.Character)
	}
}

参数

  • movie_id路径必填
    数字形式的电影 ID，例如 27205。
  • api_key查询二选一
    你的密钥。使用它，或使用 Authorization: Bearer 请求头。
  • language查询
    en-US 或 fr-FR 这样的 TMDB 标签。14 种基础语言之外的标签回退到 en。

响应字段

字段适用于说明
id顶层演职员所属的电影、剧集、季或集的 ID。
cast、crew顶层条目数组。单集演职员增加 guest_stars。
id每个条目人物 ID。用人物打开它。
name、original_name每个条目人物的姓名。
known_for_department每个条目此人总体上的主要工作，而不是在本作品中的工作。
gender、popularity、adult每个条目含义与人物记录相同。
profile_path每个条目图片路径或 null。拼接到 https://img.amodb.dev/t/p/{size}。
credit_id每个条目标识这一条演职员记录的字符串。
character演员、客串演员角色名，有些条目为空。
order演员、客串演员署名位置，0 表示第一。
department幕后人员分组，例如 Directing、Writing、Production、Camera、Editing、Sound、Art、Visual Effects、Lighting、Costume & Make-Up 或 Crew。
job幕后人员具体职务，例如 Director、Screenplay 或 Editor。

示例响应

GET /3/movie/27205/credits?language=en-US。该响应目前有 52 条演员和 735 条幕后人员记录，所以这里两个数组都缩减为两条：

JSON 
{
  "id": 27205,
  "cast": [
    {
      "adult": false,
      "gender": 2,
      "id": 6193,
      "known_for_department": "Acting",
      "name": "Leonardo DiCaprio",
      "original_name": "Leonardo DiCaprio",
      "popularity": 9.3213,
      "profile_path": "/wo2hJpn04vbtmh0B9utCFdsQhxM.jpg",
      "character": "Dom Cobb",
      "credit_id": "52fe4534c3a368484e04de03",
      "order": 0
    },
    {
      "adult": false,
      "gender": 2,
      "id": 24045,
      "known_for_department": "Acting",
      "name": "Joseph Gordon-Levitt",
      "original_name": "Joseph Gordon-Levitt",
      "popularity": 5.6202,
      "profile_path": "/z2FA8js799xqtfiFjBTicFYdfk.jpg",
      "character": "Arthur",
      "credit_id": "52fe4534c3a368484e04de0b",
      "order": 1
    }
  ],
  "crew": [
    {
      "adult": false,
      "gender": 2,
      "id": 1025090,
      "known_for_department": "Crew",
      "name": "Jim Wilkey",
      "original_name": "Jim Wilkey",
      "popularity": 0.9114,
      "profile_path": "/peEdS7ZYHwEeMJAwInJj732AeYs.jpg",
      "credit_id": "6634553bad59b501286dab5f",
      "department": "Crew",
      "job": "Stunt Driver"
    },
    {
      "adult": false,
      "gender": 2,
      "id": 1741194,
      "known_for_department": "Sound",
      "name": "James Thatcher",
      "original_name": "James Thatcher",
      "popularity": 0.6215,
      "profile_path": null,
      "credit_id": "5bcdece8925141613e0216d3",
      "department": "Sound",
      "job": "Musician"
    }
  ]
}

电视剧、季和集的演职员

下面所有路径共用基础地址 https://api.amodb.dev/3，并接受 language。

方法和路径返回内容
GET /tv/{series_id}/credits剧集的演员和幕后人员，每个人每个角色一条。
GET /tv/{series_id}/season/{season_number}/credits一季的演员和幕后人员。
GET /tv/{series_id}/season/{season_number}/episode/{episode_number}/credits一集的 crew 和 guest_stars。cast 是空数组。

在剧集、季和集的路径上用 append_to_response=credits 也能获得同样的数据。条目的结构与上面的电影演职员相同。单集的客串演员带有 character 和 order，幕后人员条目带有 department 和 job。

GET /3/tv/1399/season/1/episode/1/credits?language=en-US，数组缩减为两条：

JSON 
{
  "id": 63056,
  "cast": [],
  "crew": [
    {
      "department": "Writing",
      "job": "Writer",
      "credit_id": "5256c8a019c2956ff6046e2b",
      "adult": false,
      "gender": 2,
      "id": 9813,
      "known_for_department": "Writing",
      "name": "David Benioff",
      "original_name": "David Benioff",
      "popularity": 2.0354,
      "profile_path": "/xvNN5huL0X8yJ7h3IZfGG4O2zBD.jpg"
    },
    {
      "department": "Editing",
      "job": "Editor",
      "credit_id": "54eef2ab925141795f005d4f",
      "adult": false,
      "gender": 2,
      "id": 18077,
      "known_for_department": "Editing",
      "name": "Oral Norrie Ottey",
      "original_name": "Oral Norrie Ottey",
      "popularity": 0,
      "profile_path": null
    }
  ],
  "guest_stars": [
    {
      "character": "Benjen Stark",
      "credit_id": "5256c8b919c2956ff604836a",
      "order": 61,
      "adult": false,
      "gender": 2,
      "id": 119783,
      "known_for_department": "Acting",
      "name": "Joseph Mawle",
      "original_name": "Joseph Mawle",
      "popularity": 1.4645,
      "profile_path": "/1Ocb9v3h54beGVoJMm4w50UQhLf.jpg"
    },
    {
      "character": "Rickon Stark",
      "credit_id": "566a83bcc3a3683f56003604",
      "order": 80,
      "adult": false,
      "gender": 2,
      "id": 1050248,
      "known_for_department": "Acting",
      "name": "Art Parkinson",
      "original_name": "Art Parkinson",
      "popularity": 1.2594,
      "profile_path": "/ejAKOJME1DsvHECLWdQ7dEtXyyc.jpg"
    }
  ]
}

amodb 不提供剧集的汇总演职员，也不支持按 credit_id 查询。要获取剧集的演员表，请读取 /tv/{series_id}/credits 并按 order 对 cast 排序。

在应用中读取演员和幕后人员

任务做法
显示导演挑出 job 等于 Director 的 crew 条目。一部电影可以有多位。
显示主演按 order 对 cast 排序，取前 10 位。
给幕后人员分组按 department 分组。一个人有两个职务时会出现两次，所以请按人物 id 合并。
显示剧集演员表读取剧集的演职员，并按 order 对 cast 排序。
列出所有部门和职务读取类型与查找列表中介绍的查找列表。

错误

HTTPstatus_code何时出现
4017密钥缺失或错误。
40236套餐周期已结束。
40434电影、剧集、季或集不存在，或该路径不提供。
40537你调用了写入方法。
42925超过每分钟请求数。请等待 Retry-After 秒。

详情见错误和速率限制。

实用说明

  • 演职员和详情一样缓存 6 小时。新加入的演员可能要这么久才会出现。
  • 大型制作可能列出数百位幕后人员。渲染之前请先截取数组的一部分。
  • 没有照片的人物，profile_path 为 null。列表行用 w185，详情视图用 h632。
  • 电影和电视剧记录见电影和电视剧。季和集的记录见季与集。