Capslane icon

Capslane

Capslane 是 YouTube 字幕 API,可擷取公開影片字幕,或在字幕缺少時產生逐字稿,並提供單一端點、時間戳記輸出、語言選擇與適合正式環境的控制功能。

Capslane

概覽

Capslane 是 YouTube 逐字稿 API,可從公開影片擷取字幕,並在字幕不可用時產生逐字稿。它專為需要單一端點來進行字幕擷取、產生式備援與時間戳記輸出的開發人員打造。

API 會針對原生、產生和快取結果回傳穩定的回應契約。文件與定價頁面顯示,它支援伺服器端 API 金鑰、非同步工作、共用快取、每月用量限制,以及適用於正式環境工作流程的用量追蹤工具。

主要功能

原生字幕搭配 AI 備援

從公開 YouTube 影片擷取字幕,或在字幕缺少時產生逐字稿,使用單一 API 與單一回應契約。

彈性的輸出格式

回傳純文字或含時間戳記的片段。文件也指出支援結構化 JSON 輸出與文字模式。

語言選擇

選擇偏好的 ISO 語言代碼進行擷取。如果完全相符的字幕軌不可用,API 會改用第一個可用的逐字稿,並回報其他語言。

非同步工作流程

以非同步工作處理較長的影片。API 可回傳工作 ID,獨立的工作端點則會持續回報狀態,直到完成為止。

穩定的快取回應

透過共用逐字稿快取重複使用結果。快取、原生和產生的回應維持相同結構,簡化下游處理。

正式環境控制功能

在較高階方案中使用工作區 API 金鑰、請求歷程記錄、每月用量限制與請求記錄,以管理正式環境的使用情況。

常見使用情境

  • 具備備援逐字稿處理的影片應用程式

    為影片應用程式建立逐字稿功能:先嘗試原生字幕,字幕缺少時再改用產生的文字,同時無需變更程式碼所使用的回應結構。

  • 搜尋與分析流程

    為搜尋、分析或檢索工作流程建立逐字稿文字索引,以處理需要含時間戳記片段與一致語言中繼資料的情境。

  • 長時間執行的逐字稿工作

    使用非同步請求流程處理較長的影片,輪詢工作狀態直到逐字稿就緒,而不是讓初始請求保持阻塞。

  • 團隊 API 作業

    透過將金鑰保留在伺服器端、追蹤每月限制,以及在較高階方案中檢視請求歷程或記錄,管理團隊或產品的正式環境用量。

Pros and Cons

Pros

  • 將原生字幕擷取與產生式備援整合在單一 API 中。
  • 讓原生、產生和快取的回應維持相同格式。
  • 支援含時間戳記的片段、純文字輸出與語言選擇。
  • 提供伺服器端金鑰、工作區配額與正式環境使用情況追蹤。
  • 提供免費方案,以及適合用量成長團隊的高用量付費方案。

Cons

  • 文件指出,產生的逐字稿可能需要輪詢工作端點,因此部分請求不會立即完成。
  • 可靠性頁面指出,YouTube 的可用性會因地區、帳戶狀態與上游變更而異,因此無法保證每部影片都能涵蓋。

FAQ

如何驗證請求?

Capslane 會使用 x-api-key 標頭中的工作區 API 金鑰,將請求傳送至其 transcript API。文件說明,您應在控制面板中建立伺服器金鑰,並將其保留在伺服器端。

我可以指定逐字稿的語言嗎?

可以。API 接受偏好的 ISO 語言代碼。如果該字幕軌不可用,Capslane 會回傳第一個可用的逐字稿,並列出可用語言。

如果影片沒有字幕,會發生什麼事?

當沒有可用字幕,且模式允許產生逐字稿時,Capslane 會啟動非同步工作並回傳工作 ID。接著輪詢工作端點,直到逐字稿完成或失敗。

快取的逐字稿會回傳不同的回應格式嗎?

不會。原生、產生和快取的逐字稿都使用相同的回應結構;cached 欄位會指出是否不需要進行擷取。

有免費方案嗎?

定價頁面表示,Capslane 提供每月 50 次請求的免費方案,以及每月請求量更高的付費方案。用量每月重設,年度訂閱也同樣適用。

Quick Facts

類別
開發人員工具
主要用途
YouTube 字幕擷取與逐字稿產生
平台
Web API
驗證方式
x-api-key 標頭中的工作區 API 金鑰
來源網域
capslane.com
定價
免費方案加上付費方案