開發者文件
用於媒體在地化，供開發者與自動化代理使用的 Weydub API。
從一個經簽章的請求開始，再進入用於字幕與文字移除、影片翻譯、字幕擷取、圖片翻譯、回呼及自動化的正式環境工作流程。已登入的 Weydub 使用者可在「我的帳號」中免費啟用 API 存取權。
從開發者快速入門開始
取得憑證、發出一次經簽章的呼叫、檢查狀態，再選擇工作流程頁面。這能讓開發者快速完成操作，同時為代理提供足夠的結構，以安全地進行建置。
- 取得存取權登入、從「我的帳戶」免費開啟 API 存取權，並確認帳戶的工作流程使用權限。
- 閱讀參考文件查看端點、請求格式、狀態欄位與疑難排解說明。
- 執行快速入門使用環境變數與精簡 JSON 簽章建立一個示範工作。
- 驗證結果輪詢狀態或接收回呼，然後儲存輸出網址與錯誤。
核心工作流程
API 首頁聚焦四項正式環境工作：移除影片中的文字、翻譯影片、擷取字幕檔案，以及翻譯圖片。
移除字幕與文字
移除內嵌字幕（硬字幕）、說明字幕、浮水印、下方圖文、標誌、劇情提示、登記號碼及可見文字。
- 端點：
/v-w-c/gateway/ve/work/free - 基本版：
needChineseOcclude: 1|2|3 - Lite/Pro：
advanced_lite、advanced_large_box、advanced_full - 遮罩：
videoInpaintMasks - CRF：
extraOptions.write_options.crf（啟用時）
翻譯影片
建立翻譯字幕、選用 AI 配音，並輸出完成在地化的影片素材。
- 端點：
/v-w-c/gateway/ve/work/free - 配音：
needWanyin: 1、wyTaskType: FULL - 畫面文字：
needChineseOcclude: 11 - 強烈情緒：
/voice/incorporate
擷取字幕
透過 OCR 辨識可見字幕，或透過 ASR 辨識語音對話，以產生 SRT/VTT。
- OCR：
needChineseOcclude: 14 - OCR 遮罩：
type: trans_only_ocr - ASR：
wyTaskType: ONLY_ASR、wyNeedText: 0
先在 Weydub 試用
如果使用者想在實作前查看輸出品質，請將他們導向相符的 Weydub 工作流程。API 文件則保留在這裡，供自動化、簽署、回呼與正式環境行為使用。
正式環境規則
這些規則會載入 API 頁面，讓開發者與代理程式在實作期間使用本機 Weydub 文件。
兩種使用對象
這份文件是為使用 AI 程式設計工具的使用者，以及需要精簡可靠契約的自動化代理程式所撰寫。
依序閱讀
請先閱讀五篇核心教學。當 AI 程式設計工具或內部機器人負責實作時，請使用代理程式檔案。
整合路徑
將此內容作為指令碼、後端服務、無程式碼橋接、佇列工作程式，以及 AI-產生的用戶端之實作檢查清單。
- 免費存取從「我的帳戶」開啟 API 存取權，然後確認目標工作流程的帳戶使用權限。
- 儲存機密資訊使用
WEYDUB_APP_KEY以及WEYDUB_APP_SECRET或使用機密資訊管理工具。 - 精確簽署使用精簡 JSON、雙重 MD5 簽章，然後傳送完全相同的本文位元組。
- 建立任務提交媒體 URL，並儲存傳回的專案／工作／任務 ID。
- 穩妥等待在正式環境中使用回呼，並以輪詢作為備援。
- 儲存結果儲存輸出 URL、SRT 連結、圖片素材、狀態和錯誤資訊。
- 執行示範在連接客戶媒體前，先使用官方素材進行驗證。
- 保護使用者確保重試具冪等性，且絕不洩露 AppSecret。
最小呼叫格式
請使用環境變數儲存憑證。請勿將 AppSecret 儲存在前端程式碼、公開儲存庫、螢幕截圖、記錄檔或可能被保留的提示中。
POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free
Headers:
Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)
Body:
{
"urls": ["https://example.com/demo.mp4"],
"needChineseOcclude": 1,
"videoInpaintLang": "all"
}示範情境
在串接客戶媒體前，請使用這些公開資產驗證 API 整合。這些資產涵蓋 Weydub 預期由機器人與程式開發工具最常呼叫的工作流程。
進階文字移除
提交一部帶有英文內嵌字幕（硬字幕）的影片，並使用 Advanced Pro 全螢幕模型。
情境 2影片翻譯
使用字幕與 AI 配音，將英文示範影片翻譯成西班牙文。
情境 3高情緒聲音複製
使用中文影片與配對的 JSON，進行短劇中文轉英文配音。
- 英文影片：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4 - 中文影片：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4 - 中文 JSON：
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json
複製為 Markdown
這個區塊會同步呈現概覽內容，來源為 index.md，讓使用者可以將其貼到 AI 程式設計工作階段中，代理程式也能將其解析為純 Markdown。
適用於 AI 程式設計工具
請將 Quickstart、Auth、Subtitle Removal、Video Translation、Subtitle Extraction，以及 Weydub API Skill 提供給你的助理。接著僅透過環境變數提供憑證。這是 Codex、Cursor、Claude Code、內部機器人與自動化代理程式的預期使用方式。