大規模 RAG 應用的 YouTube 逐字稿：點數、自動儲值與預算
一位開發者把 10,000 部 YouTube 影片匯入 RAG 應用。看看費用、速率限制的算法，以及自動儲值與預算如何讓支出可預測。
如果你的 RAG 或 AI 應用需要大規模取得 YouTube 逐字稿，實用的做法是：採用按用量付費、預先購買點數的逐字稿 API；設定自動儲值，讓長時間匯入不會中斷；再設定每月預算，避免程式錯誤把帳單越推越高。這個情境跟著一位開發者，用 sum.video 逐字稿 API 完成這套設定。
情境
Maya 正在打造一個研究助理，用來回答關於研討會演講的問題。她的索引需要涵蓋來自數百個頻道的約 10,000 部 YouTube 影片，之後每月再增加約 300 部新影片。她從一台小型伺服器執行匯入，不想一直盯著它，也不想被帳單嚇到。
她的條件很簡單：費用可預測、工作中途不必手動儲值，以及乾淨地處理沒有逐字稿的影片。
她需要什麼
- 每部影片的純文字，可直接切塊並做嵌入。
- 時間戳記，讓回答可以連到影片中的確切時刻。
- 開始前就能估算的費用。
- 一個明確的支出上限。
步驟說明
1. 先估算費用
一份逐字稿費用為 2 點，沒有回傳逐字稿的請求不收費。10,000 部影片最多是 20,000 點。用 $74.99 的 5,000 點包（每份 $0.030），10,000 份逐字稿總共約 $300，如果有些影片沒有字幕則會再少一些。較小的點數包每份較貴：100 點是 $0.090，500 點是 $0.056，2,000 點是 $0.038。價格頁面有最新的詳細資訊。
點數一次購買、永不過期，所以她在開發期間沒有任何訂閱時鐘在倒數。
2. 用免費點數測試
她的第一把 API 金鑰附有 10 點免費點數，也就是 5 份逐字稿。她用這些點數檢查幾部影片在 json 格式（含以秒計 offset 與 duration 的片段）與 text 格式下的回應。如果想看請求細節，指南如何用 API 取得 YouTube 逐字稿有可執行的 curl、Python 與 JavaScript 範例。
3. 設定自動儲值
在 API 儀表板中，她開啟自動儲值。規則是：當餘額低於所選水位時，就從已儲存的信用卡扣款再買一個點數包。匯入工作整夜持續執行，不需要手動儲值。
4. 設定預算
兩道上限保護著她：
- 每月儲值預算，限制自動儲值每月最多能花多少。
- 每月點數上限。達到上限後，後續請求會回傳
402 budget_exceeded。
她也開啟了低餘額、達到每月上限 80% 以及儲值失敗時的電子郵件警示。這些警示會在還來得及處理時就告訴她出了問題。
5. 遵守速率限制
每把金鑰允許每分鐘 60 次請求。照這個速度，10,000 次請求大約需要 167 分鐘，單把金鑰不到三小時。她執行一個簡單的佇列，每秒送出一個請求，因此能維持在限制之下而不會暴衝。她最多可以建立 5 把啟用中的金鑰，例如一把用於匯入、一把用於應用的即時查詢，這樣回填歷史資料就不會擋到使用者的請求。
6. 處理沒有逐字稿的影片
API 只回傳 YouTube 現有的字幕。直播、私人或已移除的影片，以及沒有字幕的影片都會回傳 404 no_transcript。在她的佇列裡，這個狀態代表標記為略過並繼續，不要重試。由於這些請求不收費，滿是無字幕影片的頻道也不會燒掉她的預算。
她的迴圈，以虛擬碼表示：
- 從佇列取出下一個影片 ID。
- 以
format=json呼叫 API。 - 成功時：把片段切成約一分鐘的區塊，連同起始 offset 一起儲存並做嵌入。
- 遇到
404 no_transcript：儲存「無逐字稿」旗標。 - 遇到
402 budget_exceeded：暫停佇列並通知自己。 - 遇到伺服器錯誤：延遲後重試。
7. 在程式中檢查餘額
在每個大批次之前，她會呼叫 GET /api/v1/credits。如果餘額低於批次所需，且自動儲值是關閉的，工作就會拒絕啟動。這是一道便宜的防護，避免匯入做到一半。
她最後得到什麼
第一晚過後，索引裡有將近全部 10,000 部影片的逐字稿，每個區塊都帶有起始時間。使用者提問時，助理會引用某場演講與時間戳記，連結會在那個時刻開啟影片。後續成本很小：每月 300 部新影片最多 600 點，以 5,000 點包每份 $0.030 計算約 $18。
如果 Maya 訂閱 Pro，每月還會額外獲得 100 點贈送點數，可以抵掉部分成長所需。
它的不足之處
- 沒有字幕就沒有逐字稿。 API 不會轉錄音訊。沒有字幕的影片需要其他來源，例如語音轉文字服務，費用另計。部分其他逐字稿 API 提供音訊備援，請見YouTube 逐字稿 API 比較。
- 自動字幕有錯誤。 人名與行話通常是受害者。回應會說明字幕軌是否為自動產生，因此你可以降低這些區塊的權重或加以標記。
- 語言是字幕軌的語言。 回應會回報實際語言，所以不要假設它與你請求的相同。
- 每把金鑰的吞吐量有上限。 非常大的回填是以小時計，不是以秒計。
- 它只回傳逐字稿。 切塊、嵌入與檢索是你的工作。如果你只需要單一影片的摘要，請使用 YouTube 摘要工具。
來源
常見問題
取得 10,000 份 YouTube 逐字稿要花多少錢？
最多 20,000 點，因為每份逐字稿是 2 點。用 $74.99 的 5,000 點包（每份 $0.030），大約是 $300。沒有逐字稿的影片不收費，所以實際總額可能更低。
長時間工作中餘額用完會怎樣？
開啟自動儲值時，餘額低於你選定的水位後，系統會從已儲存的信用卡扣款再買一個點數包，工作會繼續執行。沒有它的話，點數用完請求就會停止。
如何避免程式錯誤讓我的帳單暴增？
設定每月儲值預算與每月點數上限。達到點數上限時，請求會回傳 402 budget_exceeded。你也可以在低餘額、達到每月上限 80% 與儲值失敗時收到電子郵件警示。
速率限制是多少？
每把金鑰每分鐘 60 次請求，最多 5 把啟用中的金鑰。每秒一個請求的話，單把金鑰處理 10,000 部影片不到三小時。
沒有字幕的影片怎麼辦？
它們會回傳 404 no_transcript 且不收費。API 不會轉錄音訊，所以這些影片你需要另找來源。
