任务创建 - TransDuck API接入文档

请求参数

Path 参数

api_token

string

必需

登录 TransDuck 后台之后，点击API接入获取您的 api_token

示例值:

Body 参数application/json

url

string

视频URL

必需

videoType

string

必需

视频类型，目前支持的参数包括：YOUTUBE、BILIBILI、HTTP。
使用YOUTUBE、BILIBILI的时候，url参数直接传对应网站的url即可。
使用HTTP的时候，url参数提供一个可以在公网访问的视频地址，保证TranDuck可以通过此url下载到视频进行处理，目前仅支持mp4格式的视频，url案例：http://d1.transduck.com/example/example_1_en.mp4

from

string

源语言

必需

to

string

目标语言

必需

ttsVoice

string

配音音色

必需

callback

string

必需

回调URL，任务处理完成后，TransDuck调用该接口主动通知任务处理结果。

该接口需要用户根据该文档中的“任务回调”接口定义在自己的系统中实现。

示例

{
    "url": "https://www.youtube.com/shorts/tSTb67Qm5Os",
    "videoType": "YOUTUBE",
    "from": "en",
    "to": "zh",
    "ttsVoice": "zh-CN-YunjianNeural",
    "callback": ""
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/api/video-translate/{{API_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.youtube.com/shorts/tSTb67Qm5Os",
    "videoType": "YOUTUBE",
    "from": "en",
    "to": "zh",
    "ttsVoice": "zh-CN-YunjianNeural",
    "callback": ""
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

200-成功，500-错误

message

string

必需

如果有错误，会有错误信息

detail

object (任务详情)

必需

创建成功后，返回视频翻译任务的详情数据

id

integer

视频翻译任务ID

必需

url

string

视频URL

必需

videoType

string

视频类型

必需

from

string

视频源语言

必需

to

string

视频翻译目标语言

必需

ttsVoice

string

配音音色

必需

videoId

string

视频ID

必需

title

string

视频标题

必需

videoDuration

integer

必需

视频时长（单位：秒）

success

boolean

必需

处理结果，null - 处理中，false - 处理失败，true - 处理成功

errDesc

string

必需

错误信息（任务处理失败才有，不然为null）

resultVideo

string

必需

处理结果1：不含背景音的视频URL

resultVideo2

string

必需

处理结果2：不含背景音的视频URL

resultSubtitle

string

必需

处理结果3：字幕压缩包URL，包含：原始字幕、翻译字幕、双语字幕

callback

string

必需

任务结果回调通知URL

success

boolean

必需

true-成功，false-失败

示例

{
    "code": "string",
    "message": "string",
    "detail": {
        "id": 0,
        "url": "string",
        "videoType": "string",
        "from": "string",
        "to": "string",
        "ttsVoice": "string",
        "videoId": "string",
        "title": "string",
        "videoDuration": 0,
        "success": true,
        "errDesc": "string",
        "resultVideo": "string",
        "resultVideo2": "string",
        "resultSubtitle": "string",
        "callback": "string"
    },
    "success": true
}