すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:バッチ動画制作のパブリックパラメーター

    ドキュメントセンター

    Intelligent Media Services:バッチ動画制作のパブリックパラメーター

    最終更新日:Nov 09, 2025

    このトピックでは、バッチ動画制作の共通パラメーターについて説明します。

    説明

    このドキュメントは主に、スクリプトベースの自動動画制作、インテリジェント画像テキストマッチング動画制作 - 一般シナリオ、インテリジェント画像テキストマッチング動画制作 - フィルムコレクションシナリオ、およびハイエネルギー混合動画制作タスクの共通パラメーターについて説明します。これらの共通パラメーターの使用例については、各タスクのパラメーター説明ドキュメントをご参照ください。

    SubHeading パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Level

    Integer

    サブタイトルレベル。

    列挙:

    1: レベル 1 サブタイトル

    2: レベル 2 サブタイトル

    3: レベル 3 サブタイトル

    4: レベル 4 サブタイトル

    5: レベル 5 サブタイトル

    1

    はい

    TitleArray

    List<String>

    サブタイトル配列。各合成で 1 つのサブタイトルがランダムに選択されます。

    最大 50 個のサブタイトル、各 50 文字以内。

    ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"]

    はい

    ステッカーパラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    MediaId

    String

    ステッカー、ロゴ、ウォーターマーク、またはその他のイメージの ID

    ****b4545fg6c88681030f6e****

    2 つのうち 1 つが必須です

    両方が指定された場合、MediaId が優先されます

    MediaURL

    String

    イメージ URL、ご自身の OSS のみをサポートします

    ルール: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].png

    例: http://example.oss-cn-shanghai.aliyuncs.com/example/example.png

    X

    Float

    「VideoTrackClip.X」をご参照ください

    10

    いいえ

    Y

    Float

    「VideoTrackClip.Y」をご参照ください

    100

    いいえ

    Width

    Float

    「VideoTrackClip.Width」をご参照ください

    300

    いいえ

    Height

    Float

    「VideoTrackClip.Height」をご参照ください

    300

    いいえ

    DyncFrames

    Integer

    アニメーションステッカーのフレーム数、有効値 [0,100]

    25

    いいえ、ステッカーがアニメーションの場合に記入します

    Opacity

    Float

    透明度、有効値 [0,1]、デフォルト値は 1

    0.6

    いいえ

    MediaConfig パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Volume

    String

    入力ビデオのボリューム。有効値: [0, 10.0]、小数点以下 2 桁までサポート。

    0.5

    いいえ、デフォルトは 0 です

    MediaMetaDataArray

    List<MediaMetaData>

    メディアメタデータ情報のリスト。

    詳細については、「MediaMetaData パラメーター」をご参照ください

    いいえ

    MediaMetaData パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Media

    String

    メディア ID または OSS URL、InputConfig で渡されたマテリアルと一致する必要があります。

    53fg5f9d46c88b******0f6etft6

    はい

    GroupName

    String

    メディアが属するグループ。

    重要

    このパラメーターは [スクリプトベースの自動動画制作] モードでのみ有効です。他の動画制作モードではこのパラメーターを渡さないでください。

    group1

    [スクリプトベースの自動動画制作] モードでは必須、他の動画制作モードでは不要

    TimeRangeList

    List<TimeRange>

    インポイントとアウトポイントの範囲のリスト。各マテリアルは複数のインポイントとアウトポイントを指定でき、そこからセグメントが選択されて合成されます。

    [{"In":"0","Out":"1"},{"In":"2","Out":"3"}]

    はい

    Opacity

    Float

    マテリアルの透明度、有効値 [0,1]

    重要

    透明度パラメーターを使用する場合、背景イメージ BackgroundImageArray を追加することをお勧めします。

    BackgroundImageConfig が構成されている場合、このパラメーターは有効になりません。

    0.5

    いいえ、デフォルトは 1 です

    TimeRange パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    In

    Float

    マテリアルのインポイント、単位は秒、小数点以下 4 桁まで正確

    1.1233

    はい

    Out

    Float

    マテリアルのアウトポイント、単位は秒、小数点以下 4 桁まで正確

    2.4566

    はい

    SpeechConfig パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Volume

    String

    • スピーチ音声のボリューム、デフォルトは 1。有効値: [0, 10.0]、小数点以下 2 桁までサポート。

    0.5

    いいえ、デフォルトは 1 です

    AsrConfig

    JSON

    • 字幕パラメーター構成をサポートします。フィールドの詳細については、「バナーテキスト」をご参照ください。

    {"Alignment":"TopCenter","AdaptMode":"AutoWrap","Font":"Alibaba PuHuiTi 2.0 65 Medium","SizeRequestType":"Nominal","Spacing":-1,"Y":0.8}

    いいえ

    Voice

    String

    • 1 つまたは複数の公式の音声トーンをカンマで区切って指定します。複数の音声が指定された場合、1 つがランダムに選択されて合成されます。利用可能な音声トーンについては、「インテリジェントスピーチ効果の例」をご参照ください。

    zhimiao_emo,zhilun

    いいえ

    SpeechRate

    • 話速、有効値: -500～500。

    • [-500, 0, 500] は話速の倍率 [0.5, 1.0, 2.0] に対応します。

    説明

    話速の計算メソッド:

    • 0.8x 速度: (1-1/0.8)/0.002 = -125

    • 1.2x 速度: (1-1/1.2)/0.001 = 166

    1x 未満の速度の場合、0.002 の係数を使用します。

    1x を超える速度の場合、0.001 の係数を使用します。

    実際のアルゴリズム結果は近似値を取ります。

    100

    いいえ、デフォルトは 0 です

    Style

    String

    スピーチの音声スタイル。指定されたスタイルからランダムに音声トーンが選択されます。デフォルトは空です。Voice と Style の両方が指定された場合、Voice が優先されます。値:

    • "Gentle": ソフト。含まれるもの: "zhiqi", "zhijia", "zhitian", "zhiyan_emo", "zhinan", "zhichu", "zhiyuan"。

    • "Serious": シリアス。含まれるもの: "zhiru", "zhixiang", "zhilun", "zhifeng_emo"。

    • "Entertainment": エンターテイメント。含まれるもの: "zhiqing", "zhiwei", "zhibei_emo"。

    音声の例については、「インテリジェントスピーチ効果の例」をご参照ください。

    Gentle

    いいえ

    CustomizedVoice

    String

    カスタマイズされた音声トーンをサポートします。音声クローニングの VoiceId (標準版と公開版の両方をサポート) を入力します。このフィールドが入力されている場合、Voice と Style は無効になります。

    Voice-test1

    いいえ

    SpecialWordsConfig

    JSON

    字幕 (スピーチ) のローカル効果構成、単語のハイライトと禁止用語のフィルタリングをサポートします。パラメータータイプは配列です。

    重要

    現在のバージョンでは、このパラメーターは [スクリプトベースの自動動画制作 - グループスピーチ] モードのみをサポートしており、将来的には他の動画制作モードと互換性を持つようになります。

    [{"Type":"Highlight","Style":{"FontName":"KaiTi","FontSize":80,"FontColor":"20AEE9","OutlineColour":"2D20E9","Outline":3,"FontFace":{"Bold":true,"Underline":true}},"WordsList":["ApsaraVideo","Intelligent Media Services","Batch video production"]},{"Type":"Highlight","Style":{"FontFace":{"Italic":true}},"WordsList":["product","look"]},{"Type":"Forbidden","WordsList":["pitter-patter","bilibili"],"SoundReplaceMode":"None"}]

    いいえ

    SpeechLanguage

    String

    字幕 (スピーチ) の言語:

    • zh: 中国語

    • en: 英語

    重要

    現在のバージョンでは、このパラメーターは [スクリプトベースの自動動画制作] モードのみをサポートしています。このパラメーターが "en" の場合、SpeechConfig.AsrConfig.AdaptMode を AutoWrapAtSpaces に設定することをお勧めします

    zh

    いいえ。デフォルトは zh です

    SpecialWordsConfig パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Type

    String

    特殊単語のタイプ、有効値:

    • Highlight: 単語のハイライト

    • Forbidden: 禁止用語のフィルタリング

    Highlight

    はい

    WordsList

    List<String>

    特殊単語のリスト、最大 20 単語、各単語は 5 文字以内。

    ["ApsaraVideo","Intelligent Media Services","Batch video production"]

    はい

    Style

    JSON

    Type = Highlight の場合に必須です

    {"FontFace":{"Italic":true}}

    いいえ

    SoundReplaceMode

    String

    • 特殊単語に対応する音声を他の音に置き換えるメソッド。Type = Forbidden の場合に必須です。

    • 有効値:

      • None: 置き換えなし

      • Beep: 元の音を「ピー」音に置き換え

      • UserDefined: カスタム

    None

    いいえ

    SoundEventUrl

    String

    SoundReplaceMode = UserDefined の場合に必須です。効果音ファイルを渡すことをサポートします。16 ビット、モノラル、16000Hz サンプリングレートの wav ファイルである必要があります。アクセス可能な任意のダウンロードアドレスをサポートします。

    https://www.example.com/files/audio/example_sound.wav

    いいえ

    Style パラメーター

    名前

    タイプ

    説明

    例

    必須

    FontName

    String

    字幕名、カスタムフォントは現在サポートされていません。

    KaiTi

    いいえ

    FontColor

    String

    フォントの色。[BBGGRR] 16 進数カラー BGR 値、色の順序は通常の RGB と逆です。

    00FF7F

    いいえ

    OutlineColour

    String

    罫線の色。[BBGGRR] 16 進数カラー BGR 値、色の順序は通常の RGB と逆です。

    EBCE87

    いいえ

    BackColour

    String

    影の色。[BBGGRR] 16 進数カラー BGR 値、色の順序は通常の RGB と逆です。

    EBDE87

    いいえ

    FontSize

    Integer

    フォントサイズ、単位はピクセル。

    100

    いいえ

    Outline

    Integer

    概要の幅、単位はピクセル。

    3

    いいえ

    FontFace

    JSON

    フォントスタイル

    {"Bold":true,"Italic":true,"Underline":true}

    いいえ

    FontFace パラメーター

    名前

    タイプ

    説明

    例

    必須

    Bold

    Boolean

    太字

    false

    いいえ

    Italic

    Boolean

    斜体

    false

    いいえ

    Underline

    Boolean

    下線

    false

    いいえ

    BackgroundMusicConfig パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    Volume

    String

    バックグラウンドミュージックのボリューム。有効値: [0, 10.0]、小数点以下 2 桁までサポート。

    0.5

    いいえ、デフォルトは 0.2 です

    Style

    String

    バックグラウンドミュージックのスタイル、デフォルトは空です。InputConfig でバックグラウンドミュージックがすでに構成されている場合、このフィールドは有効になりません。値:

    • "bgm-beauty": ファッション

    • "bgm-chinese-style": 中華風

    • "bgm-cuisine": 料理

    • "bgm-dynamic": ダイナミック

    • "bgm-quirky": 風変わり

    • "bgm-relaxing": リラックス

    • "bgm-romantic": ロマンチック

    • "bgm-upbeat": 明るい

    bgm-beauty

    いいえ

    LoopMode

    Boolean

    バックグラウンドミュージックのループモード

    • true: 自動ループを示します

    • false: 再生終了後に停止を示します

    true

    いいえ、デフォルトは true です

    AFadeOutDuration

    Float

    バックグラウンドミュージックのフェードアウト時間、単位: 秒。値: 0 以上、バックグラウンドミュージックのマテリアル時間以下。

    2.0

    いいえ、デフォルトは 2.0 です

    BackgroundImageConfig パラメーター

    パラメーター

    タイプ

    説明

    例

    必須

    SubType

    String

    バックグラウンドタイプ。有効値:

    • "Color": 単色背景

    • "Blur": ぼかし背景

    Color

    いいえ

    Radius

    Float

    ぼかし半径、SubType=Blur の場合に有効、有効値 [0.01, 1]

    0.5

    いいえ

    Color

    String

    背景色。SubType=Color の場合に有効、16 進数 RGB カラー。

    #000000

    いいえ

    バナーテキストパラメーター

    説明

    タイトル (TitleConfig)、サブタイトル (SubHeadingConfig)、および字幕 (SpeechConfig.AsrConfig) の構成パラメーターは、以下の共通パラメーターを使用します。「バッチ動画制作」は「通常編集」に依存してバナーテキストの合成を実装し、バナーテキストのスタイルと効果を事前に最適化しています。したがって、バッチ動画制作における字幕のデフォルト値は、通常編集と完全に一致するわけではありません。TitleConfig、SubHeadingConfig、または SpeechConfig.AsrConfig フィールドにデフォルト値がない場合、「バッチ動画制作」が追加の構成を行っていないことを意味し、実際のデフォルト値は通常編集のデフォルト値 (以下の表の第 3 列「説明」のデフォルト値) と一致します。

    パラメーター

    タイプ

    説明

    例

    必須

    TitleConfig

    SubHeadingConfig

    SpeechConfig.AsrConfig

    TimelineIn

    Float

    テキストのインポイント、単位は秒、小数点以下 4 桁まで正確

    1.1233

    いいえ

    デフォルト値なし

    デフォルト値なし

    このパラメーターはサポートされていません

    TimelineOut

    Float

    テキストのアウトポイント、単位は秒、小数点以下 4 桁まで正確

    2.4566

    いいえ

    デフォルト値なし

    デフォルト値なし

    このパラメーターはサポートされていません

    X

    Float

    バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセルの両方のフォーマットをサポートします。値が [0～0.9999] の場合、出力ビデオの幅に対する比率を表します。値が整数 >=2 の場合、絶対ピクセルを表します。デフォルトは 0 です。この座標はマテリアルサイズと出力ビデオサイズに応じてスケーリングされます。

    0.1

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Y

    Float

    バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセルの両方のフォーマットをサポートします。値が [0～0.9999] の場合、出力ビデオの高さに対する比率を表します。値が整数 >=2 の場合、絶対ピクセルを表します。デフォルトは 0 です。この座標はマテリアルサイズと出力ビデオサイズに応じてスケーリングされます。

    0.2

    いいえ

    「パラメーター "Y" のデフォルト値の説明」をご参照ください

    「パラメーター "Y" のデフォルト値の説明」をご参照ください

    「パラメーター "Y" のデフォルト値の説明」をご参照ください

    Font

    String

    バナーテキストのフォント。サポートされているフォントについては、「フォントリスト」をご参照ください。

    SimSun

    いいえ

    Alibaba PuHuiTi 2.0 95 ExtraBold

    Alibaba PuHuiTi 2.0 95 ExtraBold

    Alibaba PuHuiTi 2.0 65 Medium

    FontSize

    Int

    バナーテキストのフォントサイズ。このフォントサイズはマテリアルサイズと出力ビデオサイズに応じてスケーリングされます。デフォルトは 0、最大サポート設定は 5000 です。

    注記:

    • FontSize と FixedFontSize のいずれか 1 つのみを入力できます。両方が入力された場合、FontSize のみが有効になります。

    24

    いいえ

    「TitleConfig.FontSize のデフォルト値の説明」をご参照ください

    「SubHeadingConfig.Level.FontSize のデフォルト値の説明」をご参照ください

    「SpeechConfig.AsrConfig.FontSize のデフォルト値の説明」をご参照ください

    SizeRequestType

    String

    フォントサイズから実際のテキストレンダリングサイズへの計算メソッド。

    • Nominal: 字幕のレンダリング高さ (ピクセル値) はフォントサイズ FontSize と等しくなります。

    • RealDim: 一部のフォントでは、字幕のレンダリング高さ (ピクセル) がフォントサイズ FontSize より小さくなる場合があります。

    Nominal

    いいえ

    Nominal

    Nominal

    Nominal

    FixedFontSize

    Int

    バナーテキストのフォントサイズ。このフォントサイズはマテリアルサイズと出力ビデオサイズに応じてスケーリングされません。

    注記:

    • FontSize と FixedFontSize のいずれか 1 つのみを入力できます。両方が入力された場合、FontSize のみが有効になります。

    14

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    FixedX

    Float

    バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセルの両方のフォーマットをサポートします。値が [0～0.9999] の場合、出力ビデオの幅に対する比率を表します。値が整数 >=2 の場合、絶対ピクセルを表します。デフォルトは 0 です。この座標はマテリアルサイズと出力ビデオサイズに応じてスケーリングされません。

    64

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    FixedY

    Float

    バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセルの両方のフォーマットをサポートします。値が [0～0.9999] の場合、出力ビデオの幅に対する比率を表します。値が整数 >=2 の場合、絶対ピクセルを表します。デフォルトは 0 です。この座標はマテリアルサイズと出力ビデオサイズに応じてスケーリングされません。

    64

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    FontColor

    String

    バナーテキストの色、フォーマットは # の後に 16 進数値が続きます。

    #ffffff

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    FontColorOpacity

    String

    バナーテキストの透明度、テキストの透明度を表し、有効値は 0-1 です。1 は不透明、0 は完全に透明です。

    0.5

    いいえ

    1

    1

    1

    FontFace

    FontFace

    バナーテキストのフォントの外観、すべてデフォルトで false です。

    {"Bold":true,"Italic":true,"Underline":true}

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Spacing

    Integer

    バナーテキストの文字間隔。単位: ピクセル値。

    1

    いいえ

    0

    「SubHeadingConfig.Spacing のデフォルト値の説明」をご参照ください

    -1

    LineSpacing

    Integer

    バナーテキストの行間隔。単位: ピクセル値。デフォルトは 0 です。

    1

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Angle

    Float

    バナーテキストの反時計回りの回転角度。単位: 度。デフォルトは 0 です。

    5

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    BorderStyle

    Int

    バナーテキストの罫線と影のフォーマットを設定します。値 1 または 3、1=罫線+影、3=不透明な背景。デフォルトは 1 です。

    3

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Outline

    Int

    バナーテキストの概要の幅。単位: ピクセル値。デフォルトは 0 です。

    1

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    OutlineColour

    String

    バナーテキストの概要の色、フォーマットは # の後に 16 進数値が続きます。

    #ffffff

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Shadow

    Int

    バナーテキストによってキャストされる影の深さ、単位: ピクセル値。デフォルトは 0 です。

    3

    いいえ

    0

    0

    0

    BackColour

    String

    バナーテキストの影の色、フォーマットは # の後に 16 進数値が続きます。

    #ffffff

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Alignment

    String

    バナーテキストの位置合わせメソッド、設定をサポート:

    • TopLeft: ビデオの左上隅

    • TopCenter: ビデオの垂直軸の上側

    • TopRight: ビデオの右上隅

    • CenterLeft: ビデオの水平軸の左側

    • CenterCenter: ビデオの中央位置

    • CenterRight: ビデオの水平軸の右側

    • BottomLeft: ビデオの左下隅

    • BottomCenter: ビデオの垂直軸の下側

    • BottomRight: ビデオの右下隅

    異なる配置メソッドで字幕の位置を正確に配置するには、次の配置メソッドを設定することをお勧めします:

    • Left、左揃え、X、Y は、ビデオの左上隅に対する字幕の左上隅の座標を渡します

    • Center、中央揃え、X、Y は、ビデオの左上隅に対する字幕の中心軸と上境界の交点の座標を渡します

    • Right、右揃え、X、Y は、ビデオの左上隅に対する字幕の右上隅の座標を渡します

    TopLeft

    いいえ

    TopCenter

    TopCenter

    TopCenter

    AdaptMode

    String

    バナーテキストがビデオの幅または指定された TextWidth を超えると、自動的に折り返すかスケーリングされます:

    • AutoWrap: 自動改行

    • AutoScale: 自動スケーリング

    • AutoWrapAtSpaces: スペース位置でのみ自動改行 (純粋な英語の字幕の自動折り返しシナリオに適しています)

    AutoWrapAtSpaces

    いいえ

    AutoWrap

    AutoWrap

    AutoWrap

    TextWidth

    String

    字幕テキストボックスの幅、AdaptMode が設定されている場合に有効です。テキストボックスの幅はこの値に従って自動折り返しまたはスケーリングのために設定されます。入力されていない場合、ビデオの幅に従って自動的に折り返すかスケーリングされます。値が 0 より大きく 1 以下の場合、出力ビデオに対する相対的な幅を表します。値が 1 より大きい場合、絶対ピクセル値を表します。

    0.8

    いいえ

    0.8

    0.8

    0.8 ～ 0.9 の間でランダム

    FontUrl

    String

    バナーテキストは、ユーザーの OSS フォントファイルパスを使用して字幕を生成することをサポートし、ttf、otf、および woff フォントファイル形式をサポートします。

    ルール: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].ttf

    例:

    https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    EffectColorStyle

    String

    バナーテキストのファンシー文字スタイルタイプ。「ファンシー文字効果の例」をご参照ください。FontColor、FontColorOpacity、BorderStyle、Outline、OutlineColour、Shadow、BackColour、SubtitleEffects、TextureURL、BubbleStyleId、BubbleWidth、BubbleHeight が構成されている場合、EffectColorStyle は有効になりません

    CS0001-000001

    いいえ

    「タイトルスタイル、スピーチスタイル、背景イメージスタイルスイートのデフォルト値」をご参照ください

    「タイトルスタイル、スピーチスタイル、背景イメージスタイルスイートのデフォルト値」をご参照ください

    「タイトルスタイル、スピーチスタイル、背景イメージスタイルスイートのデフォルト値」をご参照ください

    SubtitleEffects

    SubtitleEffect[]

    バナーテキストの多層効果。現在、複数の概要レイヤー、複数の影レイヤー、ガウスぼかし効果 (ガウスぼかしはタイプが影の場合にのみサポートされます)、および字幕背景効果の設定をサポートしています。

    注記:

    • SubtitleEffects が設定されている場合、字幕トラックの Outline および Shadow フィールドは有効にならなくなります。

    • 複数の概要/影/背景効果レイヤーを設定する場合、SubtitleEffects 配列の順序がレイヤーの順序を表します。配列の最初の SubtitleEffect は最下層にレンダリングされ、配列の最後の SubtitleEffect は最上層にレンダリングされます。

    [{"Type":"Outline"},{"Type":"Shadow"}]

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    AaiMotionInEffect

    String

    字幕タイプがバナーテキストの場合、バナーテキストの入場効果タイプを表します。複数のタイプをカンマで区切って設定することをサポートします。「字幕効果の例」をご参照ください

    blur_in,wave_in

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    AaiMotionIn

    Float

    バナーテキストの入場効果の時間。単位: 秒、小数点以下 4 桁まで正確。AaiMotionIn が入力されていない場合、デフォルトは 0.5s です。テキストの時間が 0.5 未満の場合、合計時間から退場時間を引いた時間になります。

    0.5

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    AaiMotionOutEffect

    String

    字幕タイプがバナーテキストの場合、バナーテキストの退場効果タイプを表します。複数のタイプをカンマで区切って設定することをサポートします。「字幕効果の例」をご参照ください

    blur_in,wave_in

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    AaiMotionOut

    Float

    字幕タイプがバナーテキストの場合、バナーテキストの退場効果の時間を表します。単位: 秒、小数点以下 4 桁まで正確。AaiMotionOut が入力されていない場合、デフォルトは 0.5s です。テキストの時間が 0.5 未満の場合、合計テキスト時間になります。

    0.5

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    AaiMotionLoopEffect

    String

    字幕タイプがバナーテキストの場合、バナーテキストのループ効果タイプを表します。字幕の入場または退場効果と同時に有効にすることはできません。複数のタイプをカンマで区切って設定することをサポートします。「字幕効果の例」をご参照ください

    blur_in,wave_in

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    Ratio

    Float

    字幕タイプがバナーテキストの場合、バナーテキストのループ効果の再生速度を表し、小数点以下 4 桁まで正確です。1 は通常の速度のループを表し、1 より大きい場合は加速ループ、1 未満の場合は低速ループを表します。デフォルトは 1 です。

    1.2

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    TextureURL

    String

    字幕タイプがバナーテキストの場合、字幕のテクスチャ効果を表します。PNG、JPG、JPEG、BMP 形式をサポートします。現在、OSS ファイルの受け渡しのみをサポートしています。

    https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    BubbleStyleId

    String

    字幕タイプがバナーテキストの場合、バナーテキストのバブル文字スタイルタイプを表します。バブルのタイプと効果については、「バブル文字の例」をご参照ください

    BS0001-000001

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    BubbleWidth

    Float

    バブル文字を使用する場合にのみ有効で、出力ビデオに対するバブル背景イメージの幅を表します。1 より大きい場合は絶対ピクセル値を表し、1 以下の場合は相対値を表します。

    24

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    BubbleHeight

    Float

    バブル文字を使用する場合にのみ有効で、出力ビデオに対するバブル背景イメージの高さを表します。1 より大きい場合は絶対ピクセル値を表し、1 以下の場合は相対値を表します。

    24

    いいえ

    デフォルト値なし

    デフォルト値なし

    デフォルト値なし

    デフォルト値の説明

    パラメーター "Y" のデフォルト値の説明

    出力ビデオサイズ

    TitleConfig.Y

    SubHeadingConfig.Y

    SpeechConfig.AsrConfig.Y

    縦 (縦横比 3:4 以下)

    0.1

    デフォルト値なし

    0.8

    横 (縦横比 4:3 以上)

    0.05

    デフォルト値なし

    0.9

    正方形 (縦横比が 4:3 より大きく、3:4 未満)

    0.08

    デフォルト値なし

    0.85

    TitleConfig のデフォルト値の説明

    説明

    表のデフォルト値は、「縦 1080×1920」、「横 1920×1080」、「正方形 1080×1080」のサイズについてそれぞれ説明されています。他の出力ビデオサイズの FontSize のデフォルト値は、次の数式を使用して計算できます。

    パラメーター定義:

    • 「newOutputHeight」=「ターゲットサイズの高さ」と定義します。

    • 「oldOutputHeight」=「元のサイズの高さ」と定義します。

    • 「newOutputWidth」=「ターゲットサイズの幅」と定義します。

    • 「oldOutputWidth」=「元のサイズの幅」と定義します。

    • 「ratio」=「比率」と定義します。

    • 「newFontSize」=「変換後のフォントサイズ」と定義します

    • min(a,b): a と b の小さい方の値を取ります。

    • round(a): 最も近い整数に四捨五入します。

    計算式:

    ratio = min(newOutputHeight / oldOutputHeight, newOutputWidth / oldOutputWidth);

    newFontSize = round(oldFontSize × ratio);

    ここで newFontSize は変換後のフォントサイズです

    例:

    1920×1080 で fontSize = 80 と仮定します。960×540 に変換する場合、newFontSize = 80 × min(960/1920, 540/1080) = 40

    TitleConfig.FontSize のデフォルト値の説明

    出力ビデオサイズ

    M: タイトル文字数

    fontSize のデフォルト値

    縦 - 縦横比 3:4 以下、「1080 × 1920」を例として使用

    1 < M <= 8

    119

    8 < M <= 18

    102

    M > 18

    85

    横長 - 縦横比が 4:3 以上

    横 - 縦横比 4:3 以上、「1920 × 1080」を例として使用

    1 <= M <= 13

    86

    13 < M <= 34

    67

    M > 34

    52

    正方形 - 縦横比が 4:3 より大きく、3:4 未満、例として「1080×1080」を使用

    1 < M <= 9

    76

    9 < M <= 20

    67

    M > 20

    57

    SpeechConfig.AsrConfig.FontSize のデフォルト値の説明

    出力ビデオサイズ

    M: 字幕文字数

    fontSize のデフォルト値

    縦 - 縦横比 3:4 未満、「1080 × 1920」を例として使用

    1 <= M <= 14

    68

    M > 14

    59

    横長 - 縦横比が 4:3 より大きい

    「1920×1080」を例として

    1 <= M <= 24

    48

    M > 24

    38

    正方形 - 縦横比が 4:3 より大きく、3:4 未満、例として「1080×1080」を使用

    1 <= M <= 16

    43

    M > 16

    38

    SubHeadingConfig.Level.FontSize のデフォルト値の説明

    FontSize のデフォルト値

    出力ビデオサイズ

    縦 (縦横比 3:4 以下)

    横 (縦横比 4:3 以上)

    正方形 (縦横比が 4:3 より大きく、3:4 未満)

    SubHeading.Level=1

    68

    67

    57

    SubHeading.Level=2

    59

    57

    50

    SubHeading.Level=3

    51

    48

    43

    SubHeading.Level=4

    42

    38

    36

    SubHeading.Level=5

    38

    33

    31

    SubHeadingConfig.Spacing のデフォルト値の説明

    FontSize のデフォルト値

    出力ビデオサイズ

    縦 (縦横比 3:4 未満)

    横 (縦横比 4:3 以上)

    正方形 (縦横比が 4:3 より大きく、3:4 未満)

    SubHeading.Level=1

    0.03

    0.02

    0.02

    SubHeading.Level=2

    0.03

    0.01

    0.01

    SubHeading.Level=3

    0.01

    0

    0

    SubHeading.Level=4

    0

    0

    0

    SubHeading.Level=5

    0

    0

    0

    タイトルスタイル、スピーチスタイル、背景イメージスタイルスイートのデフォルト値

    説明

    • スタイルスイートの説明: ビデオが合成されるたびに、以下のスイートから 1 つがランダムに選択されます。バッチ動画制作 API で以下のパラメーターを設定すると、スイートのデフォルトパラメーターが自動的にオーバーライドされます。

    • ランダムルール: ビデオの数を 20 に設定し、単色背景スイートを選択したとします。まず、1 から 21 (21 は単色背景スイートの総数) の間の乱数が生成されます。たとえば 16 が生成された場合、背景スイートは 16, 17, 18, 19, 20, 21, 1, 2, 3, 4, 5... の順に選択されます。

    単色背景スイート

    シーケンス

    EffectColorStyle: タイトルファンシー文字 ID

    EffectColorStyle: 字幕ファンシー文字 ID

    背景画像 mediaId

    1

    CS0004-000010

    CS0005-000003

    icepublic-76270ecd8bdbb0670e4f830ce4226d78

    2

    CS0001-000012

    CS0005-000003

    icepublic-867553776f24ba3806d046fd83d623bd

    3

    CS0003-000013

    CS0005-000003

    icepublic-6098a7e3a964e44da0950f8fc1c801c4

    4

    CS0001-000001

    CS0005-000003

    icepublic-986c6407d749d5a74bcb6e09c6452b86

    5

    CS0002-000011

    CS0005-000003

    icepublic-51cc7b3a1747b65f3f201e4fb1940584

    6

    CS0001-000003

    CS0005-000003

    icepublic-7a194df166e57ecaf2a6ea7d5d40fef6

    7

    CS0002-000016

    CS0005-000003

    icepublic-19220373b09e5964f7594740a0d90d95

    8

    CS0001-000008

    CS0005-000003

    icepublic-f538fa00133b3119c3975027261c0f16

    10

    CS0002-000012

    CS0005-000003

    icepublic-4728b79c865a727e43f2777fcd622425

    11

    CS0001-000007

    CS0005-000003

    icepublic-f38f87e54bd3cb596915f0fca88768a8

    12

    CS0003-000001

    CS0005-000003

    icepublic-090d7b5c5e6dbf94f77a0b2913f1233c

    13

    CS0002-000002

    CS0005-000003

    icepublic-6fb6aec40ddd18fd97c89f286096b13c

    14

    CS0001-000016

    CS0005-000003

    icepublic-123c94c93b441ee6274cc57af3a5f192

    15

    CS0001-000013

    CS0005-000003

    icepublic-1daf8b4e4ba14a0b65ce36a74fb6f7ed

    16

    CS0001-000005

    CS0005-000003

    icepublic-6026a4719922367ac9911da573cf4ac3

    17

    CS0004-000005

    CS0005-000003

    icepublic-e6a95f972fe9c0bade2b4bfbd14bd2b6

    18

    CS0004-000009

    CS0005-000003

    icepublic-b9d7f849a675c2e88ac5d0b6c9dc13ae

    19

    CS0003-000014

    CS0005-000003

    icepublic-d647e23699457a716ec248002d07e441

    20

    CS0004-000019

    CS0005-000003

    icepublic-80a6a9a1f1e9c92ed1fbb3c5fb273129

    21

    CS0004-000012

    CS0005-000003

    icepublic-965162f2ffba0ca333602bc868959ed1

    グラデーション背景スイート

    シーケンス

    EffectColorStyle: タイトルファンシー文字 ID

    EffectColorStyle: 字幕ファンシー文字 ID

    背景画像 mediaId

    1

    CS0003-000019

    CS0005-000003

    icepublic-436399df008b57ce0d5bf18b2018fdf7

    2

    CS0001-000014

    CS0005-000003

    icepublic-03a7dc16f773d21eb5a12c4532e83792

    3

    CS0004-000007

    CS0005-000003

    icepublic-7793fe1121bbf0c328756d30eb43fbf6

    4

    CS0004-000013

    CS0005-000003

    icepublic-e51bbb0ac440a66f5402644f15f167bc

    5

    CS0004-000015

    CS0005-000003

    icepublic-0cea2bfd1713e4be89d4cb2b69dcfd2d

    6

    CS0003-000011

    CS0005-000003

    icepublic-d94fd7ea908e5ef3e0f4776749b2ab21

    7

    CS0003-000006

    CS0005-000003

    icepublic-85a3a18ad145149720af3f60cf365dbb

    8

    CS0003-000019

    CS0005-000003

    icepublic-22e6db400a8df8629836bfd1e7d0c3e0

    9

    CS0003-000023

    CS0005-000003

    icepublic-ff9242c8573007d65e42f3497e3290fa

    10

    CS0003-000021

    CS0005-000003

    icepublic-e66f8ba4ecf0565bf03a21f818ec7bb7

    画像背景スイート

    シーケンス

    EffectColorStyle: タイトルファンシー文字 ID

    EffectColorStyle: 字幕ファンシー文字 ID

    背景画像 mediaId

    1

    CS0002-000008

    CS0005-000003

    icepublic-e0dafa38070907f0c33ccfcc98f93e80

    2

    CS0002-000009

    CS0005-000003

    icepublic-5bbf38de39b72af630a78a6a46d5c4f8

    3

    CS0003-000015

    CS0005-000003

    icepublic-3dfca71bf8a67992a84ec47b08d37a57

    4

    CS0003-000006

    CS0005-000003

    icepublic-a8ce54acc939865038196ddf2b3e4628

    5

    CS0004-000006

    CS0005-000003

    icepublic-7bc1ff25d2fe82d3d6780178be8274a8

    6

    CS0003-000004

    CS0005-000003

    icepublic-afd1755bea61c89fe2d688b2380f9fe8

    7

    CS0003-000024

    CS0005-000003

    icepublic-69a1b7dc1f3d5a02a1777f9df90861e2

    8

    CS0004-000016

    CS0005-000003

    icepublic-c14bf83acdd62760f3cbaffce5c6dddb

    9

    CS0004-000008

    CS0005-000003

    icepublic-cc46ea3761f04bc735769dfc22bc1028

    TemplateConfig パラメーター

    説明

    バッチ動画制作テンプレートの作成方法と取得方法の詳細については、「バッチ動画制作テンプレート構成パラメーターの説明」をご参照ください。

    パラメーター

    タイプ

    説明

    例

    必須

    BatchEditingTemplateIdArray

    List<String>

    • テンプレートリスト、テンプレート ID を入力、50 個に制限。各合成でリストから 1 つのテンプレートがランダムに選択されます。

    • ランダムルール: 10 個のテンプレートが渡され、ビデオの数が 20 に設定されているとします。まず、1 から 10 の間の乱数が生成されます。たとえば 3 が生成された場合、テンプレートは 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7... の順に選択されます。

    • 処理ロジック: バッチ動画制作 API の構成パラメーターは、テンプレートで設定されたパラメーターよりも優先度が高くなります。テンプレートを構成した場合、空でないパラメーターはまずバッチ動画制作タスク API から読み取られ、空のパラメーターについてはテンプレートから読み取られます。

    ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"]

    いいえ

    パラメーター例

    {
  "BatchEditingTemplateIdArray": [
    "****b4549d46c88681030f6e****", // バッチ編集テンプレート ID。
    "****549d46c88b4681030f6e****" // バッチ編集テンプレート ID。
  ]
}