如何建立 TMDB API 金鑰並將其新增至 Kodi

如果 Kodi 外掛程式要求您提供 TMDB 憑證,請透過您的 TMDB 帳戶申請一個,並將其輸入到該插件的設定中。 Kodi 本身沒有系統級的 TMDB API 金鑰字段,因此插件必須支援自訂金鑰。如果外掛程式依賴共享憑證,則個人金鑰可能會有所幫助,但這並不能繞過 TMDB 的速率限制,也不能保證修復當機問題。

以下介面圖片僅供參考。 TMDB可能會更改其帳戶控制設置,Kodi選單也會因皮膚、設備和插件的不同而有所差異。

開始之前

您需要一個 TMDB 帳戶和一個使用 TMDB API 並提供自訂憑證設定的 Kodi 插件。 TMDB 建議您使用桌面瀏覽器申請,因為其 API 註冊流程尚未針對行動裝置進行最佳化。 TMDB入門指南說明如何申請存取權限以及您必須接受的條款連結。

TMDB 列出了兩種應用程式憑證:API 金鑰(v3 認證)和API 讀取存取權杖(v4 認證)。 TMDB 將兩者都列為 API 請求的驗證方式,但特定的插件可能只接受其中一種格式。請確保憑證與外掛程式實際請求的欄位相符;切勿將 v3 金鑰貼到明確要求 v4 持有者令牌的欄位中。

如何建立 TMDB API 金鑰

  1. 建立或登入您的TMDB帳戶。存取電影資料庫(The Movie Database),如有需要,請註冊並完成其要求的任何帳戶驗證。然後使用桌面瀏覽器登入。
    範例帳戶表單,包含電子郵件和密碼欄位以及「建立帳戶」按鈕。
    您必須先註冊帳號才能申請TMDB API存取權限。
  2. 開啟 API 設定頁面。在您的帳戶中,開啟“設定”,然後在帳戶導覽中選擇“API”。目前的 TMDB 文件將 API 連結描述為帳戶設定的一部分;其特定位置或措詞可能會有所變更。
    範例帳戶設定頁面,側邊欄已選擇 API
    請在TMDB帳戶設定中尋找API條目。
  3. 發起 API 申請請求。請依照 API 頁面上的說明操作或建立流程。選擇符合您實際用途的應用程式類型,準確描述軟體及其使用方式,並在接受條款和 API 指南前仔細閱讀。請勿使用虛構的聯絡方式或項目資訊。
    範例 API 請求表單,包含應用程式類型、描述、條款複選框和提​​交按鈕。
    請描述實際使用場景,並在提交請求前接受 TMDB 的條款。
  4. 等待 TMDB 頒發憑證。申請核准後,返回 API 設定並查看兩個項目:API 金鑰(v3 認證)和 API 讀取存取權杖(v4 認證)。它們是兩個獨立的應用程式憑證。 TMDB認證指南詳細說明了可用的認證方法。
    範例 API 設定頁面,顯示了單獨的遮罩 v3 API 金鑰和 v4 讀取存取令牌行。
    TMDB 將 v3 金鑰和 v4 存取權杖顯示為單獨的憑證。
  5. 複製插件請求的憑證。如果欄位顯示為 API 金鑰,請複製API 金鑰(v3 認證)。如果它明確要求提供 API 讀取存取權杖或持有者令牌,請使用 v4 版本對應的值。不要隨意猜測,也不要將憑證發佈到公開貼文或螢幕截圖中。
    範例憑證畫面突顯了位於單獨 v4 存取權杖上方的 API 金鑰 v3 行。
    僅當插件要求提供 API 金鑰時才複製 v3 金鑰。

如何在 Kodi 中加入金鑰

  1. 開啟 Kodi 的插件區域。在主畫面上,選擇“插件”,然後開啟插件瀏覽器或已安裝的插件。不同 Kodi 版本和皮膚的插件名稱和佈局可能有所不同。
    範例 Kodi 風格的主螢幕,左側導覽列突出顯示了插件。
    從 Kodi 的插件部分開始;具體佈局取決於您的皮膚。
  2. 開啟相容插件的設定。找到從 TMDB 取得電影或電視節目元資料的插件,選取它,開啟 Kodi 的右鍵選單,然後選擇「設定」。 Kodi 的插件文件對此步驟有詳細說明。遙控器或裝置上的右鍵選單控制項名稱可能有所不同。請確認該外掛程式的文件是否支援自訂 TMDB 憑證。
    範例 Kodi 插件瀏覽器,已選取一個通用插件,並且其上下文選單中的「設定」選項已高亮顯示。
    使用所選插件的上下文選單存取其設定。
  3. 輸入密鑰並儲存。開啟插件的帳戶、元資料或 API 部分,找到其 TMDB API 金鑰欄位。貼上複製的值,檢查兩端是否有新增空格,然後選擇「確定」或「儲存」。如果外掛程式要求使用其他憑證類型,請使用 TMDB 中符合的值。僅當插件文件說明設定需要在重新啟動後生效時才重啟插件。
    範例插件設定對話框,包含 TMDb API 金鑰字段以及“確定”和“取消”按鈕
    只有相容的插件提供這樣的欄位;Kodi 沒有通用的 TMDB 密鑰框。

如果插件仍然存在錯誤

  • 沒有 API 金鑰欄位:該外掛程式可能不支援自訂 TMDB 憑證。 Kodi 沒有可以取代插件本身配置的全域設定。
  • 驗證錯誤:請檢查是否已完整複製值,以及是否使用了外掛程式指定的憑證類型。 API 金鑰和 API 讀取存取權令牌是 TMDB 帳戶設定中的不同欄位。
  • 速率限製或連線錯誤:個人金鑰並不能使請求不受 TMDB 限制。插件可能仍然發出過多請求,或者 TMDB 可能暫時不可用;在更改更多設定之前,請查看插件日誌和 TMDB 的服務狀態。
  • 類別仍然崩潰:密鑰無法修復無關的插件程式碼、過時的元資料整合或損壞的依賴項。請僅從您信任的來源更新,並遵循該插件的最新文件。較舊的指南可能會提及 Covenant 或 Elysium,但這些插件有各自的設定和版本歷史記錄;它們的選單路徑並不適用於所有 Kodi 插件。

對於非商業用途的 API,TMDB 的API 常見問題解答指出,必須註明其資料和影像的來源。商業項目請聯絡 TMDB 諮詢授權事宜。如果您只是配置現有插件,請遵循插件維護者的說明,切勿公開您的個人憑證。

留下評論

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

了解 Crackle Kodi 附加组件的安装入口、版本兼容与常见故障排查,并核实 Sony 官方关于 Crackle 服务结束的说明。本文解释插件仍可见为何不代表影片仍能播放,以及安全检查步骤,并区分服务终止、地区限制与版本不兼容,避免误把旧教程当作当前可行方案,并确认安全来源。

如何使用 Kodi 全局搜索插件查找媒体内容

如何使用 Kodi 全局搜索插件查找媒体内容

了解如何在 Kodi 中安装并使用 Global Search 全局搜索插件,快速查找电影、电视剧、剧集、音乐视频、艺人、专辑和歌曲。本文说明官方仓库安装路径、搜索步骤,以及资料库未扫描、类别未启用或插件异常时的排查方法,并解释它与在线服务搜索的区别,帮助你核对结果并安全更新插件。

如何正確解除安裝 Kodi 軟體來源

如何正確解除安裝 Kodi 軟體來源

了解如何安全地卸載 Kodi 儲存庫,單獨刪除其儲存的來源 URL,並檢查您仍需要哪些已安裝的外掛程式或相依性。

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

找到使用 Kodi 觀看網球直播的最安全方法:了解 iPlayer WWW 可以播放哪些內容、如何找到授權的轉播以及應該避免使用哪些插件。

如何在 Kodi 上觀看電影:完整新手教程

如何在 Kodi 上觀看電影:完整新手教程

學習如何透過 Kodi 從電腦、USB或 NAS 觀看電影,添加線上視訊服務,並透過清晰的設定步驟修復缺少的影片。

如何在 Kodi 上合法可靠地觀看拳擊付費直播

如何在 Kodi 上合法可靠地觀看拳擊付費直播

找到您所在國家/地區的授權串流媒體,檢查其提供者是否支援 Kodi,然後在您的電視上觀看拳擊付費直播,而無需依賴過時的插件。

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

在官方 Omega 目錄中比較五款 Kodi 皮膚,然後按照當前設定路徑安裝其中一款、自訂它或切換回去。

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

設定 Kodi 主鎖 PIN 碼,保護選定的選單,並建立單獨的兒童個人資料,其中包含您選擇的媒體來源。

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

正在尋找 1Channel Kodi 插件?了解為什麼舊的 PrimeWire 安裝指南不可靠,以及如何安全地安裝受支援的視訊外掛程式。

如何在家或外出時透過網頁介面控制 Kodi

如何在家或外出時透過網頁介面控制 Kodi

啟用 Kodi 的 Chorus2 網路介面,透過任何瀏覽器控制您的媒體,並學習如何在不將 Kodi 暴露於網路的情況下進行遠端連線。