Video Translator

API key required
Other

Real time video translation / dubbing skill. Translate user-provided video (file or URL) and return preview_url. 适用于视频直译、视频翻译、视频配音、字幕翻译出片。

Install

openclaw skills install video-translator

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

源语言规则(必须遵守)

  • 源语言支持:enzhkojafrruesde
  • 若用户明确指定源语言,必须提取并传 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=falsebilingual=false
  • 用户要求显示字幕、带字幕、烧字幕时:传 show=true
  • 用户要求双语字幕时:传 show=truebilingual=true
  • 用户未提字幕需求时不要主动开启字幕

接口调用方式

  1. 健康检查:GET /video-trans/health
  2. 提交任务:POST /video-trans/orchestrate(带 sourceLanguagetargetLanguageshowbilingual
  3. 从响应获取 job_id
  4. 轮询任务:GET /video-trans/jobs/{job_id}
  5. 直到 statussucceededfailed

返回结果处理

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