全部產品
Search
文件中心

Intelligent Media Services:SubmitVideoTranslationJob - 提交視頻翻譯任務

更新時間:Mar 21, 2026

通過本介面,您可以提交視頻翻譯任務。當前已支援字幕級翻譯(將視頻中出現的字幕翻譯為指定語言)、聲音(口播)級翻譯(將音頻中的口播內容翻譯為指定語言)與面容級翻譯(口型適配)。

介面說明

  • 在此介面中,所有媒資的 OSS URL 中的地區(region)必須與調用 OpenAPI 服務地址中的地區(region)保持一致。

  • 該介面支援每秒 30 次請求(QPS 30)。提交任務多時,會自動進入隊列並動態擴容處理,無並發執行數量限制。

  • 提交視頻翻譯任務,返回 JobId,後續可通過 JobId 調用 GetSmartHandleJob 介面來擷取任務的狀態及結果資訊。

    重要 本介面詳細的參數說明與樣本,請以此文檔為準: 視頻翻譯參數介紹與樣本

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitVideoTranslationJob

none

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

InputConfig

string

視頻翻譯任務的輸入參數

  • 支援以視頻、字幕檔案作為輸入

  • 符合 JSON 格式

{"Type":"Video","Video":"1628ae20c36******8f6f7c77a6302"}

EditingConfig

string

視頻翻譯任務的配置參數,符合 JSON 格式。

{"SourceLanguage":"zh","TargetLanguage":"en","DetextArea":"Auto"}

OutputConfig

string

視頻翻譯任務的輸出參數,支援以視頻類型、字幕檔案類型輸出。

{"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4"}

Title

string

任務標題。

測試標題

Description

string

任務描述。

測試描述

UserData

string

自訂資訊,Json 格式,長度限制為 512 位元組。

{"NotifyAddress":"http://xx.xx.xxx"}

ClientToken

string

保證請求等冪性。

測試 ClientToken

SignatureMehtod

string

自動補全,無需寫入

自動補全,無需寫入

SignatureType

string

自動補全,無需寫入

自動補全,無需寫入

詳細的參數說明與樣本,請參考:視頻翻譯參數介紹與樣本

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID

******3B-0E1A-586A-AC29-742247******

Success

boolean

調用是否成功。

取值:

  • true: 成功

  • false:失敗

true

Data

object

響應資料

JobId

string

視頻翻譯任務 ID

****d718e2ff4f018ccf419a7b71****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Success": true,
  "Data": {
    "JobId": "****d718e2ff4f018ccf419a7b71****"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情