视频翻译 - Dubbing

POST

https://mapi.yunmaovideo.com/api-v1/dubbing

将音频、视频的语音翻译为其他语言的语音，支持克隆原声、保留背景音乐，也可以使用内置音色或克隆的音色。

请求参数

Header 参数

Authorization

string

必需

您的的 api key

示例值:

******

Body 参数application/json

url

string

音视频链接

必需

需要翻译的音视频链接，需公网可访问（需 HTTPS 协议，以文件格式结尾，无 query 参数）；最大50M，最长6分钟，可定制

originLang

string

源语言

必需

视频的源语言的 Id，可以参考“语言列表”

示例值:

targetLang

string

目标语言

必需

输出视频的语言 Id，可以参考“语言列表”

示例值:

zh-cn

notify

string

回调 URL

必需

用于接收任务任务结果的回调URL，任务结果数据会通过 POST 请求发送到该地址

mode

enum<string>

翻译模式

可选

视频翻译的模式，clone: 克隆原音色；builtIn: 使用内置音色；custom: 使用定制的音色

枚举值:

clonebuiltIncustom

默认值:

clone

voiceId

string

目标语言的音色 Id

可选

mode 参数为 custom 或 buintIn 时，目标语言的音色 Id

keepBg

boolean

是否保留背景音乐

可选

默认值:

false

示例

{
  "url": "https://test.cn/123.mp4",
  "originLang": "zh-cn",
  "targetLang": "en",
  "notify": "https://test.cn/notify",
  "mode": "clone",
  "voiceId": "xiaoling",
  "keepBg": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mapi.yunmaovideo.com/api-v1/dubbing' \
--header 'Authorization: ******' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://test.cn/123.mp4",
    "originLang": "zh-cn",
    "targetLang": "en",
    "notify": "https://test.cn/notify",
    "mode": "clone",
    "voiceId": "xiaoling",
    "keepBg": true
}'

返回响应

🟢200提交成功

application/json

Body

code

integer

状态码

必需

data

object

返回数据

必需

taskId

string

必需

创建成功的任务 ID

msg

string

状态信息

必需

示例

成功示例成功示例

{
  "code": 0,
  "data": {
    "taskId": "UDG3YyXDuWg3"
  },
  "msg": ""
}

🟢200回调-翻译成功

🟢200回调-翻译失败

修改于 2024-10-23 08:31:01

更新动态

声音克隆 - Voice Cloning