在使用Synology Video Station管理本地视频时,很多用户会发现“视频仅显示文件名,没有海报、剧情简介、演员信息”——这是因为Video Station的“视频信息插件”需要从The Movie Database(TMDb)获取元数据,而获取权限的核心是“TMDb API密钥”。本文基于Synology官方知识库(https://kb.synology.cn/zh-cn/DSM/tutorial/How_to_apply_for_a_personal_API_key_to_get_video_info)内容,从“申请前提”“TMDb账户操作”“API密钥申请”“Video Station配置”四个维度,详细拆解个人API密钥的完整获取与使用流程,每个步骤标注“点击位置”“填写要求”,帮你轻松解决视频元数据缺失问题。
一、前置准备:申请API密钥前需准备的3件事(避免中途卡顿)
TMDb API密钥申请对信息完整性要求较高,提前准备好以下材料,可避免因信息缺失导致申请失败:
| 准备项目 | 具体要求 | 获取/确认方法 |
|-------------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|
| 1. TMDb账户(必需) | 需注册TMDb(The Movie Database)个人账户,邮箱需真实(用于验证),不支持临时邮箱 | 访问TMDb官网(https://www.themoviedb.org/),点击右上角“Join TMDb”注册,或“Login”登录已有账户 |
| 2. Synology NAS的IP地址 | 需提供NAS的内网IP(如192.168.1.100),用于填写“Application URL”字段(TMDb验证应用归属) | 登录DSM→“控制面板”→“网络”→“TCP/IP”→查看“IPv4地址”(内网IP,非公网IP) |
| 3. Video Station已安装 | 确保NAS已安装并启动Video Station(API密钥最终需配置到该套件) | 登录DSM→“套件中心”→“已安装”,确认Video Station状态为“已启动”;若未安装,先搜索安装 |
关键提醒:TMDb支持中文界面,注册/登录后可在右上角“EN”处切换为“中文”,后续操作更直观,建议优先切换。
二、步骤1:注册/登录TMDb账户(基础前提,需验证邮箱)
TMDb API密钥申请必须绑定已验证的账户,若已有账户可跳过注册,直接登录;若无账户,按以下步骤注册:
1. 注册TMDb账户
1. 打开TMDb官网(https://www.themoviedb.org/),点击右上角“Join TMDb”(中文界面为“加入TMDb”);
2. 填写注册信息(需真实有效,否则无法通过验证):
- Email Address:输入常用邮箱(如xxx@163.com),后续需接收验证邮件;
- Password:设置密码(需8位以上,含大小写字母+数字);
- First Name/Last Name:填写姓名(可中文,如“张”“三”);
- 勾选“我已阅读并同意服务条款和隐私政策”,点击“Create Account”(创建账户);
3. 验证邮箱:
登录注册邮箱,找到TMDb发送的“Verify Your Email”邮件(可能在垃圾邮件文件夹),点击邮件中的“Verify Email”按钮,完成账户验证(未验证的账户无法申请API密钥)。
2. 登录TMDb账户
验证完成后,返回TMDb官网,点击右上角“Login”,输入邮箱和密码,点击“Sign In”(登录);
登录后,右上角会显示账户头像(默认灰色图标),说明已成功进入账户后台。
三、步骤2:申请TMDb API密钥(核心步骤,Developer身份注册)
TMDb API密钥分“Developer”和“Professional”两类,个人用户需选择“Developer”身份(免费,适合非商业用途),按以下步骤操作,每一步需严格按要求填写:
1. 进入TMDb账户设置页面
1. 点击右上角“账户头像”(中文界面为“个人资料”图标),在下拉菜单中选择“Settings”(中文界面为“设置”);
2. 进入“Settings”页面后,左侧菜单会显示多个选项(如“Edit Profile”“Account Settings”),滚动页面找到“API”选项(通常在左侧菜单底部,图标为代码形状),点击进入“API Details”页面。
2. 发起API密钥申请
1. 在“API Details”页面中,找到“Request an API Key”(申请API密钥)区域,点击下方的“click here”链接(中文界面为“点击此处”);
2. 系统会弹出“选择API密钥类型”窗口,需选择“Developer”(开发者,个人/非商业用途),不要选择“Professional”(企业/商业用途,需付费或审核);
3. 点击“Developer”选项,进入“API密钥注册表单”页面(此页面信息填写错误会直接导致申请失败,需仔细核对)。
3. 填写API密钥注册表单(每一项都有要求)
表单需填写5个核心字段,官方对每个字段的要求及填写示例如下:
| 表单字段 | 官方要求 | 填写示例(直接可用) |
|-------------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------|
| Type of Use(使用类型) | 从下拉菜单选择,个人用户必须选“Personal”(个人用途) | 下拉选择“Personal” |
| Application Name(应用名称) | 需明确指向“Video Station”,让TMDb知道API用途 | “Synology Video Station”(简洁,直接说明应用) |
| Application URL(应用URL) | 必须填写Synology NAS的内网IP(无需加端口,TMDb仅验证归属,不访问该地址) | “http://192.168.1.100”(按你NAS的实际内网IP填写,http/https均可) |
| Application Summary(应用简介) | 需详细描述API使用场景,强调“非商业、个人使用”,避免被判定为违规用途 | “用于Synology NAS上的Video Station视频信息插件,获取电影、电视剧的元数据(如海报、剧情简介、演员列表、上映时间),仅个人管理本地视频使用,不用于商业盈利,会严格遵循TMDb使用条款并标注数据来源” |
| 联系人信息(姓名/邮箱/电话) | 姓名与账户注册一致,邮箱为注册邮箱,电话可选填(格式无括号/横杠,如13800138000) | 姓名:张XX;邮箱:xxx@163.com;电话:13800138000(可选,填则格式正确) |
4. 填写完成后,仔细检查是否有遗漏(如“Application Summary”未说明用途),确认无误后点击页面底部“Submit”(提交)按钮;
5. 提交后,系统会自动审核(个人用途审核较快,通常10秒内完成),审核通过后会跳转回“API Details”页面,此时页面会显示“API Key (v3 auth)”字段——这就是你需要的API密钥(一串20位左右的字母+数字组合),复制并保存该密钥(建议粘贴到记事本,后续配置需用)。
四、步骤3:将API密钥配置到Video Station(激活视频信息插件)
获取API密钥后,需在Video Station中配置,才能让插件正常从TMDb获取元数据,步骤如下(DSM 7.0/6.2通用,以7.0为例):
1. 打开Video Station并进入设置:
登录DSM桌面,找到“Video Station”图标(橙色播放键形状),双击打开;
在Video Station主界面,点击右上角“设置”图标(齿轮形状),进入“设置”窗口。
2. 进入视频信息插件配置页面:
在“设置”窗口左侧菜单中,找到“高级设置”(或直接搜索“视频信息插件”),点击进入;
右侧会显示“视频信息插件”板块,找到“API密钥”字段(标注“TMDb API Key”),此时该字段为空。
3. 粘贴API密钥并验证:
将步骤2中复制的“API Key (v3 auth)”粘贴到“API密钥”字段中;
点击“保存”按钮(部分版本需点击“应用”),系统会自动验证密钥有效性——若验证通过,无报错提示;若提示“API密钥无效”,需返回TMDb确认密钥是否复制正确(无多余空格),或表单填写是否有误。
4. 验证插件效果:
配置完成后,在Video Station中添加一个新视频(如电影《肖申克的救赎》),或右键点击已有视频,选择“刷新元数据”;
等待10-30秒,若视频封面显示电影海报,点击视频进入详情页能看到“剧情简介”“演员”“上映时间”等信息,说明API密钥配置成功,插件已正常工作。
五、关键注意事项:遵循TMDb规则,避免API密钥失效
TMDb API密钥免费使用,但有严格的使用条款,违反会导致密钥被封禁,需重点注意以下3点:
1. 必须标注TMDb数据来源(归因要求)
官方明确规定:使用TMDb的元数据(如海报、简介)时,必须在Video Station的显式位置标注“数据来源:The Movie Database (TMDb)”——Video Station默认已满足此要求(在视频详情页底部会显示归因信息),无需手动操作,但不要通过修改插件隐藏该标注(否则违规)。
2. 仅限个人非商业用途
申请时选择“Personal”类型,意味着API密钥仅能用于个人管理本地视频,禁止用于商业场景(如收费视频服务、企业公共视频库);若用于商业用途,需重新申请“Professional”类型API密钥,否则会被TMDb检测并封禁密钥。
3. 妥善保管API密钥,避免泄露
API密钥相当于访问TMDb数据的“钥匙”,泄露后可能被他人滥用(如超量请求导致你的账户被限制);建议:
- 不要将密钥分享给他人;
- 不要在公共网络(如网吧)配置Video Station插件;
- 若怀疑密钥泄露,可在TMDb“API Details”页面点击“Regenerate API Key”(重新生成密钥),旧密钥会立即失效。
六、常见问题:API申请/配置失败的4类高频问题及解决方法
1. 问题1:提交API表单后,提示“Application URL无效”
核心原因:URL格式错误(如带端口、用公网IP、多输空格),或未填写“http/https”前缀;
解决:按官方要求填写“http://内网IP”(如http://192.168.1.100),不要加端口(如:5000),不要用公网IP,删除URL前后的空格。
2. 问题2:配置到Video Station后,提示“API密钥无效”
核心原因:密钥复制错误(多输/漏输字符)、账户未验证邮箱、表单填写违规(如用途填“商业”却选Personal);
解决步骤:
1. 重新复制TMDb“API Key (v3 auth)”字段的密钥(建议用“复制”按钮,不要手动输入);
2. 确认TMDb账户已验证邮箱(未验证会导致密钥未激活);
3. 若仍无效,在TMDb“API Details”页面查看“API状态”,若显示“Disabled”,需联系TMDb支持(通过官网“Support”板块)申诉。
3. 问题3:申请时找不到“Request an API Key”链接
核心原因:账户未登录,或登录后未进入正确的“API Details”页面;
解决:重新登录TMDb→点击账户头像→“Settings”→左侧菜单“API”→滚动页面找到“Request an API Key”区域,确保页面加载完整(可刷新或更换浏览器)。
4. 问题4:刷新视频元数据后,仍无海报/简介
核心原因:视频文件名不规范(如“电影1.mp4”,TMDb无法匹配),或API密钥未生效;
解决:
1. 将视频文件名修改为“电影名+年份”格式(如“肖申克的救赎 1994.mp4”),便于TMDb识别;
2. 右键点击视频→“刷新元数据”,等待30秒后查看;
3. 若仍无效,重新进入Video Station设置,确认API密钥已正确粘贴,且无多余空格。
总结
Synology Video Station获取TMDb元数据的核心是“申请Developer类型的API密钥”,整个流程的关键在于“TMDb表单填写准确”和“密钥正确配置”。只要按本文步骤准备材料、注册账户、填写合规信息,再将密钥配置到Video Station,就能让本地视频显示丰富的海报、剧情和演员信息,大幅提升视频管理体验。
需始终牢记:TMDb API免费使用的前提是遵循使用条款,尤其是归因和非商业用途,避免因违规导致密钥失效。若遇到复杂问题(如密钥被封禁),可直接访问TMDb官网“Support”板块提交工单,或参考Synology官方知识库补充说明。
要不要我帮你整理一份“TMDb API密钥申请信息填写模板” ?模板会包含“Application Name”“Application URL”“Application Summary”的标准填写内容,你只需替换NAS的内网IP和个人信息,就能直接用于申请,避免因填写不规范导致失败。

地址:北京市海淀区白家疃尚品园 1号楼225
北京群晖时代科技有限公司
