全部產品
Search

搜尋本產品

    ApsaraVideo Live：AddLiveAISubtitle

    文件中心

    ApsaraVideo Live：AddLiveAISubtitle

    更新時間：Sep 04, 2026

    呼叫AddLiveAISubtitle新增字幕範本。

    介面說明

    使用說明

    • 本介面支援新增直播字幕範本設定，範本設定支援描述字幕內容、版面配置等資訊。

    • 新增字幕範本後，您還需要呼叫 AddLiveAIProduceRules 介面新增字幕規則，重新推流後，串流中才能帶有字幕。

    • 即時字幕僅支援北京、上海、新加坡、印尼、沙烏地阿拉伯區域。

    重要 目前即時字幕功能處於公測階段，單一使用者最多可新增 300 個字幕範本。暫時免費使用，公測結束後將正常收費，具體時間另行通知。

    QPS 限制

    本介面的單一使用者 QPS 限制為 60 次/秒。超過限制，API 呼叫會被限制流量，這可能會影響您的業務，請合理呼叫。更多資訊，請參見 QPS 限制。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    live:AddLiveAISubtitle

    create

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    地域 ID。

    cn-shanghai
    SubtitleName

    string

    是

    字幕範本名稱，僅支援數字、大小寫字母或短橫線-，短橫線不可位於首位。

    sub01
    SrcLanguage

    string

    是

    來源語言，取值：

    • 英文：en-US

    • 中文：zh-CN

    • 俄文：ru-RU

    zh-CN
    DstLanguage

    string

    否

    翻譯目標語言，取值：

    • 英文：en-US

    • 中文：zh-CN

    • 西班牙文：es-ES

    • 俄文：ru-RU

    zh-CN
    FontColor

    string

    否

    字型顏色，RGBA 值。

    0xFFFFFF
    FontName

    string

    否

    字型，取值：

    • KaiTi-楷體，預設

    • AlibabaPuHuiTi-Regular-阿里巴巴普惠體-常規

    • AlibabaPuHuiTi-Bold-阿里巴巴普惠體-粗體

    • AlibabaPuHuiTi-Light-阿里巴巴普惠體-細體

    • NotoSansHans-Regular-思源黑體-常規

    • NotoSansHans-Bold-思源黑體-粗體

    • NotoSansHans-Light-思源黑體-細體

    KaiTi
    BgColor

    string

    否

    字幕背景顏色，RGBA 值。

    0xFF0000
    PositionNormalized

    array

    是

    字幕位置資訊，以螢幕左下角為起點的 x,y 軸座標。

    說明

    x,y 需要進行正規化計算。實際數值需要乘以畫面高度。如畫面高度為 720p 設定的 PositionNormalized 為[0.1,0.5] ，則字幕的實際位置是 x 軸為 72，y 軸為 360。

    [0.32,0.27]

    number

    否

    字幕位置座標值。

    0.32
    ShowSourceLan

    boolean

    否

    是否顯示來源語言，ShowSourceLan 預設為 false。

    true
    MaxLines

    integer

    否

    顯示行數。

    2
    WordPerLine

    integer

    是

    每行顯示字數，取值範圍：支援輸入【1,500】內的整數。

    20
    FontSizeNormalized

    number

    是

    字型大小，取值範圍：【0,1】

    0.037
    BorderWidthNormalized

    number

    否

    字型粗細，取值範圍：【0,1】

    0.05
    BgWidthNormalized

    number

    否

    字幕背景大小，取值範圍：【0,1】

    0.09
    CopyFrom

    string

    否

    複製的字幕範本，傳值 SubtitleName。

    sub01
    Description

    string

    否

    自訂字幕描述資訊。可包含中英文、數字、字元，不超過 128 個字元。

    live AI subtitle template
    Width

    string

    否

    預覽畫面寬度，單位：px。

    1280
    Height

    string

    否

    預覽畫面高度，單位：px。

    預覽畫面寬度 x 高度僅支援以下規格：

    • 橫向流暢 360P 640x360

    • 直向流暢 360P 360x640

    • 橫向標清 480P 854x480

    • 直向標清 480P 480x854

    • 橫向高清 720P 1280x720

    • 直向高清 720P 720x1280

    • 橫向超清 1080P 1920x1080

    • 直向超清 1080P 1080x1920

    720

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    5c6a2a0df228-4a64-af62-20e91b96****
    SubtitleId

    string

    字幕範本 ID。

    445409ec-7eaa-461d-8f29-4bec2eb9****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5c6a2a0df228-4a64-af62-20e91b96****",
  "SubtitleId": "445409ec-7eaa-461d-8f29-4bec2eb9****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParameter %s. 您輸入的參數無效，請檢查輸入的參數是否完整正確。
    400 MissingParameter %s. 參數缺失。
    400 InvalidParameter.Malformed There are invalid parameters: %s. 存在無效參數：%s。

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

    變更歷史

    更多資訊，參考變更詳情。