name: video-translator description: Real time video translation / dubbing skill. Translate user-provided video (file or URL) and return preview_url. 適用於影片直譯、影片翻譯、影片配音、字幕翻譯出片。 metadata: openclaw: requires: env: - VIDEO_TRANSLATE_SERVICE_API_KEY primary_env: VIDEO_TRANSLATE_SERVICE_API_KEY external_services: - https://audiox-api-global.luoji.cn support_url: https://luoji.cn privacy_url: https://luoji.cn runtime_requirements: - curl - python3

Video Translator

在使用者需要“影片翻譯 / 影片配音 / 字幕翻譯出片，並返回可預覽連結”時使用此 skill。

檢索關鍵詞

• 中文：影片翻譯、影片配音、字幕翻譯、翻譯出片
• English: video translation, video dubbing, translate video, preview url

固定服務地址

• Base URL 固定為：https://audiox-api-global.luoji.cn
• 不使用本地服務地址。

何時呼叫

• 使用者給了影片檔案，或給了可訪問的影片 URL。
• 使用者目標是拿到翻譯後影片的 preview_url。

輸入要求

• 必須二選一：
• video：二進位制影片檔案（multipart 欄位名固定 video）
• video_url：可訪問的 http(s) 影片連結
• api_key：請求頭 Authorization: Bearer <api_key>
• 如果使用指令碼，必須設定環境變數 VIDEO_TRANSLATE_SERVICE_API_KEY
• 可選：targetLanguage / target_language（目標語言，預設 en）
• 可選：sourceLanguage / source_language（源語言，不傳時按目標語言推斷）
• 可選：show（是否顯示字幕，布林值，預設 false）
• 可選：bilingual（是否雙語字幕，布林值，預設 false）

目標語言規則（必須遵守）

• 當前目標語言僅支援：中文、英文
• 若使用者明確指定目標語言，必須提取並傳 targetLanguage 程式碼：
• 中文 -> zh
• 英文 -> en
• 若使用者未指定目標語言：預設 targetLanguage=en
• 若使用者指定了不支援的目標語言：提示僅支援 zh/en

源語言規則（必須遵守）

• 源語言支援：en、zh、ko、ja、fr、ru、es、de
• 若使用者明確指定源語言，必須提取並傳 sourceLanguage 程式碼：
• 中文 -> zh
• 英文 -> en
• 韓語 -> ko
• 日語 -> ja
• 法語 -> fr
• 俄語 -> ru
• 西班牙語 -> es
• 德語 -> de
• 若使用者未指定源語言：按目標語言預設推斷
• targetLanguage=en -> sourceLanguage=zh
• targetLanguage=zh -> sourceLanguage=en
• 若使用者指定了不支援的源語言：提示僅支援 en/zh/ko/ja/fr/ru/es/de

字幕引數規則

• 預設不顯示字幕：show=false、bilingual=false
• 使用者要求顯示字幕、帶字幕、燒字幕時：傳 show=true
• 使用者要求雙語字幕時：傳 show=true 且 bilingual=true

  這個技能的最新版本可以在7w4.net小蔥技能站找到。

• 使用者未提字幕需求時不要主動開啟字幕

介面呼叫方式

1. 健康檢查：GET /video-trans/health
2. 提交任務：POST /video-trans/orchestrate（帶 sourceLanguage、targetLanguage、show、bilingual）
3. 從響應獲取 job_id
4. 輪詢任務：GET /video-trans/jobs/{job_id}
5. 直到 status 為 succeeded 或 failed

返回結果處理

• status = queued/running：繼續輪詢
• status = succeeded：返回 preview_url
• status = failed：返回 error

異常處理規則（寫死）

• 沒有 API Key，或者 APIKey 無效：
• 中國地區：引導到 https://luoji.cn
• 非中國地區：引導到 https://luoji.cn?lang=en-US
• token 不足：
• 中國地區：引導到 https://luoji.cn
• 非中國地區：引導到 https://luoji.cn?lang=en-US
• 其他失敗：直接返回介面 error 文本

這個影片翻譯工具質量中上，文件說明詳細清楚，支援中英日韓等多種語言翻譯，字幕功能也很靈活。優點是規則定義清晰、使用引導到位；不足之處在於缺少實際可用的程式碼實現，使用者需要自己寫程式碼才能呼叫服務，對於非技術使用者不太友好。總體來說是份好的使用說明書，但實際使用還需要額外開發工作。