5分钟搞定Posterizarr API密钥配置：TMDB、TVDB、Fanart.tv申请攻略

5分钟搞定Posterizarr API密钥配置TMDB、TVDB、Fanart.tv申请攻略【免费下载链接】Posterizarr️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/PosterizarrPosterizarr是一款强大的自动化海报制作工具专为Plex、Jellyfin和Emby媒体服务器设计能够自动从各大媒体数据库获取高质量的无文字海报和背景图片。想要充分发挥Posterizarr的强大功能API密钥配置是关键的第一步。本文将详细介绍如何在5分钟内完成TMDB、TVDB和Fanart.tv三大平台的API密钥申请和配置让你快速上手这款出色的海报自动化工具。为什么需要API密钥Posterizarr通过API接口从各大媒体数据库获取高质量的图片资源包括电影海报、电视剧海报、背景图片和标题卡片等。这些API密钥是访问这些资源的通行证没有它们Posterizarr就无法获取到高质量的海报图片。Posterizarr支持从多个数据源获取内容每个数据源都有其独特的优势TMDBThe Movie Database提供丰富的电影和电视剧元数据图片质量高且更新及时TVDBThe TV Database专注于电视剧内容提供详细的剧集信息和海报Fanart.tv提供高质量的粉丝艺术作品包括海报、背景和标志第一步TMDB API密钥申请TMDB是Posterizarr最推荐的数据源提供丰富的电影和电视剧资源。申请TMDB API密钥非常简单申请步骤访问TMDB官网打开 https://www.themoviedb.org/注册账号点击右上角Join TMDB注册新账号进入设置页面登录后点击右上角头像 → Settings申请API密钥在左侧菜单选择API点击Create按钮填写申请信息应用名称Posterizarr应用类型选择Personal应用描述填写用于个人媒体服务器的海报自动化工具获取API密钥创建成功后在API Key (v3 auth)部分找到你的API密钥配置方法在Posterizarr的配置文件config.json中找到tmdbtoken字段将获得的API密钥填入ApiPart: { tmdbtoken: 你的TMDB_API密钥, // 其他配置项... }第二步TVDB API密钥申请TVDB专注于电视剧内容对于电视剧海报获取非常重要申请步骤访问TVDB官网打开 https://thetvdb.com/注册账号点击Sign Up注册新账号创建API密钥登录后进入仪表板点击API Keys → Create New Key填写申请信息应用名称Posterizarr应用类型选择Personal Use应用描述填写个人媒体服务器海报工具获取API密钥创建成功后复制API密钥特别提示如果你是TVDB订阅用户可以在API密钥后添加PIN码格式为API密钥#PIN码。例如abc123def456#7890配置方法在config.json中找到tvdbapi字段ApiPart: { tvdbapi: 你的TVDB_API密钥, // 如果是订阅用户tvdbapi: API密钥#PIN码 }第三步Fanart.tv API密钥申请Fanart.tv提供高质量的粉丝艺术作品包括透明标志和艺术图片申请步骤访问Fanart.tv官网打开 https://fanart.tv/注册账号点击Register注册新账号验证邮箱完成邮箱验证流程申请API密钥登录后进入Account页面找到API Key部分创建新密钥点击Create a new API key填写申请信息应用名称Posterizarr应用描述填写个人媒体服务器海报自动化工具获取API密钥创建成功后复制API密钥配置方法在config.json中找到FanartTvAPIKey字段ApiPart: { FanartTvAPIKey: 你的Fanart.tv_API密钥, // 其他配置项... }第四步Posterizarr配置文件设置完成三个API密钥的申请后需要进行Posterizarr的完整配置配置文件位置Posterizarr的配置文件位于项目根目录的config.json文件。首次使用时可以复制config.example.json为config.json进行修改。关键配置项说明API密钥部分这是最重要的配置部分ApiPart: { tvdbapi: 你的TVDB_API密钥, tmdbtoken: 你的TMDB_API密钥, FanartTvAPIKey: 你的Fanart.tv_API密钥, FavProvider: tmdb, OverrideProviderOrder: false, ProviderOrder: [TMDB, TVDB, Fanart, Plex] }媒体服务器配置根据你使用的媒体服务器进行配置PlexPart: { PlexUrl: http://192.168.1.93:32400, UsePlex: true }, JellyfinPart: { JellyfinUrl: http://192.168.1.93:8096, UseJellyfin: false }, EmbyPart: { EmbyUrl: http://192.168.1.93:8096/emby, UseEmby: false }语言偏好设置控制海报的语言优先级PreferredLanguageOrder: [xx, en, de], PreferredSeasonLanguageOrder: [xx, en, de]第五步测试配置并开始使用完成所有配置后就可以开始使用Posterizarr了启动PosterizarrWindows用户运行Posterizarr.ps1PowerShell脚本Docker用户使用docker-compose up -d启动容器Web UI访问打开浏览器访问http://localhost:5000验证API密钥是否生效在Posterizarr Web界面检查状态运行一次测试任务查看是否能正常获取海报检查日志文件确认没有API密钥相关的错误常见问题解决API密钥无效检查密钥是否正确复制确保没有多余的空格访问限制部分API有请求频率限制如果遇到429错误请稍后再试图片获取失败检查网络连接确保能够访问对应的API服务高级配置技巧1. 数据源优先级设置Posterizarr允许自定义数据源的搜索顺序。如果你希望优先使用Fanart.tv的资源可以这样配置FavProvider: fanart, OverrideProviderOrder: true, ProviderOrder: [Fanart, TMDB, TVDB, Plex]2. 图片质量筛选通过设置最小尺寸要求确保只获取高质量的图片WidthHeightFilter: true, PosterMinWidth: 2000, PosterMinHeight: 3000, BgTcMinWidth: 3840, BgTcMinHeight: 21603. 语言偏好优化根据你的媒体库内容设置合适的语言顺序PreferredLanguageOrder: [xx, en, zh, ja, ko], LibraryLanguageOverrides: { 日本动漫: { PreferredLanguageOrder: [xx, ja, en] } }最佳实践建议1. 定期更新API密钥部分API密钥有有效期限制建议定期检查如果发现获取失败首先检查API密钥是否仍然有效2. 合理设置请求频率避免短时间内大量请求以免触发API限制Posterizarr内置了合理的请求间隔无需额外设置3. 备份配置文件将配置好的config.json文件备份到安全位置更新Posterizarr版本时可以直接复用配置文件4. 监控运行状态启用通知功能及时了解运行状态定期检查日志文件确保一切正常运行总结通过本文的5分钟快速指南你已经成功完成了Posterizarr三大核心API密钥的申请和配置。现在你的Posterizarr已经具备了从TMDB、TVDB和Fanart.tv获取高质量海报图片的能力。记住正确的API密钥配置是Posterizarr正常工作的基础。如果遇到任何问题首先检查API密钥是否正确然后查看Posterizarr的日志文件获取详细错误信息。开始享受Posterizarr带来的自动化海报管理体验吧你的媒体库将拥有统一、美观、高质量的海报展示让观影体验更加完美。✨官方文档参考docs/configuration.md 提供了完整的配置说明和高级选项。【免费下载链接】Posterizarr️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/Posterizarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考