すべてのプロダクト
Search

このプロダクト

    :AddLiveAISubtitle

    ドキュメントセンター

    :AddLiveAISubtitle

    最終更新日:Aug 15, 2025

    AddLiveAISubtitle 操作を呼び出して、字幕テンプレートを追加できます。

    操作説明

    使用方法

    • この操作を使用して、ライブ字幕テンプレートを追加できます。テンプレートには、字幕の内容、レイアウト、その他の情報が記述されています。

    • 字幕テンプレートを追加した後、AddLiveAIProduceRules 操作を呼び出して字幕ルールを追加する必要もあります。 アップストリーミングを再開すると、再生ストリームに字幕が含まれます。

    • リアルタイム字幕機能は、中国 (北京)、中国 (上海)、シンガポール、インドネシア (ジャカルタ)、サウジアラビア (リヤド) リージョンでのみ使用できます。

    重要

    リアルタイム字幕機能はパブリックプレビュー中です。 各ユーザーは最大 300 個の字幕テンプレートを追加できます。 この機能は、パブリックプレビュー中は無料です。 パブリックプレビュー終了後は、この機能の料金が発生します。 終了日は別途発表されます。

    QPS 制限

    この操作のクエリ/秒 (QPS) 制限は、ユーザーごとに 60 呼び出し/秒です。 制限を超えると、API 呼び出しがスロットルされます。 これはビジネスに影響を与える可能性があります。 呼び出しはそれに応じて計画してください。 詳細については、「QPS 制限」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    live:AddLiveAISubtitle

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    タイプ

    必須 / 任意

    説明

    例
    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: KaiTi フォント。 これはデフォルト値です。

    • AlibabaPuHuiTi-Regular: Alibaba PuHuiTi Regular

    • AlibabaPuHuiTi-Bold: Alibaba PuHuiTi Bold

    • AlibabaPuHuiTi-Light: Alibaba PuHuiTi Light

    • NotoSansHans-Regular: Noto Sans CJK SC Regular

    • NotoSansHans-Bold: Noto Sans CJK SC Bold

    • NotoSansHans-Light: Noto Sans CJK SC Light

    KaiTi
    BgColor

    string

    任意

    RGBA 形式の字幕の背景色。

    0xFF0000
    PositionNormalized

    array

    必須

    字幕の位置。

    number

    任意

    字幕の位置。 座標は x 軸と y 軸に基づいており、原点 (0,0) は画面の左下隅にあります。

    説明

    x 座標と y 座標は正規化する必要があります。 実際の値は、正規化された値にビデオの高さを掛けて計算されます。 たとえば、ビデオの高さが 720p で、PositionNormalized を [0.1,0.5] に設定した場合、字幕の実際の位置は x = 72、y = 360 になります。

    [0.32,0.27]
    ShowSourceLan

    boolean

    任意

    ソース言語を表示するかどうかを指定します。 デフォルト値は false です。

    true
    MaxLines

    integer

    任意

    表示する行数。

    2
    WordPerLine

    integer

    必須

    1 行あたりに表示する文字数。 有効な値: 1 ～ 500。

    20
    FontSizeNormalized

    number

    必須

    フォントサイズ。 有効な値: 0 ～ 1。

    0.037
    BorderWidthNormalized

    number

    任意

    フォントの太さ。 有効な値: 0 ～ 1。

    0.05
    BgWidthNormalized

    number

    任意

    字幕の背景サイズ。 有効な値: 0 ～ 1。

    0.09
    CopyFrom

    string

    任意

    設定をコピーする字幕テンプレート。 このパラメーターをソーステンプレートの名前に設定します。

    sub01
    Description

    string

    任意

    字幕テンプレートのカスタム説明。 説明には、漢字、英字、数字、特殊文字を含めることができます。 説明は最大 128 文字まで入力できます。

    live AI subtitle template
    Width

    string

    任意

    プレビュービデオの幅 (ピクセル単位)。

    1280
    Height

    string

    任意

    プレビュービデオの高さ (ピクセル単位)。

    プレビュービデオの解像度 (幅 × 高さ) は、次のいずれかである必要があります。

    • 横長 LD (360p): 640 × 360

    • 縦長 LD (360p): 360 × 640

    • 横長 SD (480p): 854 × 480

    • 縦長 SD (480p): 480 × 854

    • 横長 HD (720p): 1280 × 720

    • 縦長 HD (720p): 720 × 1280

    • 横長 FHD (1080p): 1920 × 1080

    • 縦長 FHD (1080p): 1080 × 1920

    720

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

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

    string

    字幕テンプレートの ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter %s.
    400 MissingParameter %s.
    400 InvalidParameter.Malformed There are invalid parameters: %s.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。