跳至 MCP 參考文件

MCP 文件

在 AI 助理中使用您的逐字稿。

連接用戶端瀏覽工具
本頁內容

Taption MCP

將 Taption 連接至相容 MCP 的用戶端，即可在對話中轉錄及翻譯影音、閱讀完成的逐字稿與翻譯，並瀏覽最近的工作。

模型上下文協定（MCP）讓助理代表您呼叫 Taption 工具。此自訂連線支援讀取逐字稿，以及建立轉錄與翻譯工作。

Streamable HTTPOAuth 2.1

伺服器網址

https://api.taption.com/mcp-custom

新增 Taption 遠端 MCP 伺服器時，請使用完整網址。

傳輸方式
Streamable HTTP
驗證方式
OAuth 2.1

使用條件

  • Taption 帳號，無須付費訂閱。若使用電子郵件與密碼登入，連接前須先驗證電子郵件。
  • 建立轉錄與翻譯工作需有可用的分鐘數，並受帳號方案與使用限制約束。
  • 支援遠端 Streamable HTTP 及 OAuth 登入的用戶端。用戶端方案及工作區政策可能影響存取。

支援的媒體來源

可使用影音檔案直連網址、公開的 Google Drive 檔案或 YouTube 影片。自訂端點也支援 Facebook、Instagram、TikTok、X、Threads、Vimeo、Dailymotion、Bilibili（bilibili.tv）的公開貼文，以及 Twitch 影片與剪輯。

ChatGPT 的檔案整合可用時，也能提供已上傳的影音檔案。其他用戶端可使用可下載的媒體網址。

Taption 必須能存取連結。不支援直播，請使用已結束的錄影。

設定用戶端

選擇您的應用程式，查看完整的逐步設定指南。

驗證

Taption 使用 OAuth 2.1 與 PKCE。登入 Taption 並核准連線後，用戶端會處理授權並自動更新有效期一小時的存取權杖。

MCP 使用 OAuth 存取權杖，無法使用 Taption REST API 金鑰驗證。

設定全程請使用 /mcp-custom 網址。為 /mcp 核發的權杖無法用於 /mcp-custom。

若要撤銷存取，請在 Taption 的「帳戶 → 已連接的應用程式」中中斷用戶端連線。之後可重新連接並授權。

連線權限

transcripts:read
讀取逐字稿狀態與內容，並列出最近的逐字稿。
transcripts:write
使用帳號分鐘數建立轉錄與翻譯工作。

支援的工作流程

提供媒體與所需輸出，助理會使用 Taption 工具完成以下步驟。

  1. 選擇媒體與輸出

    提供連結或支援的上傳檔案、語音語言與用途：一般逐字稿、說話者標記或字幕。開始前，助理會詢問缺少的選項。

  2. 轉錄並追蹤進度

    transcribe 立即傳回 ID。get_transcript 會短暫等待即將完成的工作；若仍在處理中，約一分鐘後再詢問。若在 Taption 開啟了電子郵件通知，完成時也會收到郵件。

  3. 閱讀、摘要與匯出

    在助理中閱讀完成的文字或請助理摘要內容。可用時開啟 SRT 下載與編輯器連結，Taption 編輯器另提供其他匯出格式。

試著詢問助理

請轉錄這段英語錄影，並標記兩位說話者：[your media URL]。
請為這段日語影片建立字幕：[your media URL]。每行使用 16 個字元。
請將這段英語訪談轉錄為字幕，再翻譯成日語和西班牙語：[your media URL]。
請將我的「Weekly sync」逐字稿翻譯成繁體中文。
找出我最近的 Taption 逐字稿，並摘要已完成的訪談。如果有字幕下載與編輯器連結，也請附上。

將 [your media URL] 換成您的連結。摘要由助理根據逐字稿產生；字幕長度自訂功能依 Taption 方案而定。

transcribe

建立工作transcripts:write

建立背景轉錄工作。提供 media_url 或 file，語音語言及用途必須由使用者指定。缺少任何一項時會詢問，不會開始工作。加入 translate_to，轉錄完成後即自動翻譯逐字稿。

參數

media_urlstring擇一媒體來源

支援的媒體連結，最多 2,048 個字元。與 file 擇一提供。

fileobject擇一媒體來源

用戶端提供的上傳檔案，需有 download_url 與 file_id；mime_type、file_name 為選填。Taption 必須能下載該網址。

languagestring開始前必須提供

語音語言標籤，例如 en-US、zh-TW、ja-JP、es-ES。請詢問使用者，不可從檔名或對話語言推測。

查看支援的語言標籤
purposestring開始前必須提供

transcript：含標點的文字；speakers：說話者標記；captions：短字幕片段。僅要求「轉錄」並不代表已選用途。

transcriptspeakerscaptions
speaker_countinteger

speakers 的預估說話者數：2–10。未提供時預設為 2。

max_charactersinteger

符合資格的付費方案可為 captions 設定每行 1–200 個字元。zh/ja/ko/yue 預設為 16，其他語言為 65。

translate_tostring[]

選填。轉錄完成後要翻譯的 1–5 種語言，例如 en、ja 或 zh-TW。每個語言另扣除與媒體長度相同的分鐘數。

extensionstring

無法自動判斷上傳格式時提供副檔名，連結不需要。支援音訊與部分影片格式，不支援 3gp。

namestring

逐字稿名稱，最多 200 個字元。省略時使用來源檔名。

工具參數範例

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

以下為示範值，請換成您的媒體網址或逐字稿 ID。

傳回逐字稿 ID 與狀態。每次成功建立都會新增工作並消耗轉錄分鐘數；translate_to 的每個語言另扣除與媒體長度相同的分鐘數。請用原 ID 查詢進度，避免重複提交。

get_transcript

唯讀transcripts:read

查詢進度，或以含時間戳記的文字、SRT、VTT 讀取已完成的逐字稿。傳入 language 可讀取其中一份翻譯。首頁會在可用時包含 download_url 與 editing_url，並列出逐字稿的翻譯及其狀態。

參數

idstring必填

transcribe 或 list_transcripts 傳回的逐字稿 ID，包含 1–128 個英文字母、數字、底線或連字號。

languagestring

要讀取的翻譯語言代碼，例如 ja。省略則讀取原始逐字稿。

formatstring

輸出格式，預設為 text。

textsrtvtt
offsetinteger

從 0 開始的片語位置，預設為 0。使用傳回的 next_offset 讀取下一頁。

limitinteger

每頁最多片語數：1–500，預設為 200。

工具參數範例

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

以下為示範值，請換成您的媒體網址或逐字稿 ID。

將 next_offset 作為 offset 讀取下一頁。每頁最多 30,000 個字元，MCP 僅能讀取前 2,000 個片語；完整內容請至 Taption。完成但無語音的錄影會傳回 total_phrases: 0。

translate_transcript

建立工作transcripts:write

將已完成的逐字稿翻譯成最多五種語言。若您以名稱指稱逐字稿，助理會用 list_transcripts 尋找，無法明確對應時會請您選擇。目標語言必須由使用者指定。

參數

idstring必填

transcribe 或 list_transcripts 傳回的逐字稿 ID，包含 1–128 個英文字母、數字、底線或連字號。

target_languagesstring[]必填

1–5 個翻譯語言代碼，例如 en、ja、es 或 zh-TW。逐字稿不能翻譯成其本身的語言。

overwriteboolean

設為 true 以取代既有翻譯，包括在 Taption 中的編輯。僅在使用者同意後使用。

工具參數範例

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

以下為示範值，請換成您的媒體網址或逐字稿 ID。

傳回已排入的語言及每個語言扣除的分鐘數（與媒體長度相同）。既有翻譯可能含有您的編輯，只有在您同意後以 overwrite 才會取代。請用 get_transcript 搭配 language 讀取結果。

list_transcripts

唯讀transcripts:read

依修改時間由新至舊瀏覽逐字稿，傳回 ID、名稱、狀態、語言、翻譯與修改時間。傳入 query 可依名稱尋找逐字稿。使用 ID 呼叫 get_transcript 讀取內容。

參數

limitinteger

最多傳回逐字稿數：1–50，預設為 10。

querystring

要在最近 100 份逐字稿中尋找的名稱片段，不分大小寫。

工具參數範例

{
  "query": "weekly sync",
  "limit": 10
}

以下為示範值，請換成您的媒體網址或逐字稿 ID。

沒有錄影時傳回空的 transcripts 陣列。此工具限制結果數量，不提供分頁。

疑難排解

連線或權限錯誤

以 OAuth 重新連接並允許要求的權限，確認網址以 /mcp-custom 結尾。

無法下載媒體

確認檔案或貼文為公開、格式受支援且非直播。Google Drive 須開啟連結存取。

分鐘數不足或工作過多

請檢查 Taption 可用分鐘數。若達速率或同時處理上限，請等待現有工作完成並依指定延遲重試。

仍在處理或轉錄失敗

處理中時約每分鐘查詢同一 ID。狀態為 error 時，請閱讀失敗訊息並排除原因後再建立工作。

更多匯出格式

在 Taption 開啟逐字稿，可匯出 TXT、PDF、SRT、VTT、Final Cut Pro XML、JSON 或內嵌字幕影片。MCP 沒有獨立匯出工具。

閱讀 REST API 文件