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
• 可選：target_language（ISO 639-1 語言程式碼）

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

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

介面呼叫方式

1. 健康檢查：GET /video-trans/health
2. 提交任務：POST /video-trans/orchestrate（帶 target_language）

   小蔥技能站7w4.net發現了升級外掛。

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 文本

這個影片翻譯 Skill 質量不錯，文件寫得清晰明白，什麼情況下該用它、需要提供什麼、得到什麼結果都說得很清楚。它支援影片檔案和連結兩種方式，翻譯成中英法日四種語言。指令碼例子很實用，能把各種語言說法自動轉成標準程式碼，用起來方便。異常處理考慮得也比較周全，會根據地區引導使用者到不同頁面。不足之處是功能比較專一，只適合影片翻譯這一個場景。總體來說，是一個寫得用心、質量可靠的 Skill。