すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:タイムライン設定

最終更新日:Sep 05, 2026

タイムラインは、トラック上に素材を配置し、効果を適用してビデオを制作するものです。サンプルタイムラインの詳細については、「ユースケース」をご参照ください。

パラメーター

タイプ

必須

説明

VideoTracks

VideoTrack[]

いいえ (ビデオトラックが存在しない場合は、オーディオトラックが必須です。)

ビデオトラックです。ビデオトラックは、`MediaId` 配列要素のシーケンスに基づいて重ね合わせられます。たとえば、最初の `MediaId` 配列要素に対応するトラックは、2 番目の `MediaId` 配列要素に対応するトラックの下に配置されます。

AudioTracks

AudioTrack[]

いいえ (オーディオトラックが存在しない場合は、ビデオトラックが必須です。)

オーディオトラックです。

ImageTracks (イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。)

ImageTrack[]

いいえ (イメージトラックが存在する場合は、ビデオトラックが必須です。)

イメージトラックです。注意事項:

1. イメージトラックはビデオトラックの上に配置する必要があります。画像と動画の制作シナリオで、画像を素材として動画と合成する場合は、ビデオトラックを使用してください。

2. イメージトラックは、`MediaId` 配列要素のシーケンスに基づいて重ね合わせられます。たとえば、最初の `MediaId` 配列要素に対応するトラックは、2 番目の `MediaId` 配列要素に対応するトラックの下に配置されます。

SubtitleTracks

SubtitleTrack[]

いいえ

字幕トラックです。

EffectTracks

EffectTrack[]

いいえ

エフェクトトラックです。

VideoTrack

動画素材と画像素材を配置します。

パラメーター

タイプ

必須

説明

Type

String

いいえ

ビデオトラックのタイプです。デフォルトでは、通常のビデオトラックが使用されます。

`Type` を `Effect` に設定すると、ビデオトラックをエフェクトに使用できます。この場合、`VideoTrackClips` で EffectTrackItem オブジェクトを指定できます。

MainTrack

Boolean

いいえ

現在のビデオトラックがメイントラックであるかどうかを指定します。デフォルト値:False。詳細については、「メイントラックの設定」をご参照ください。

TrackShortenMode

String

いいえ

現在のビデオトラックの長さがメイントラックの長さより長い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に短縮されます。このパラメーターは、トラックを短縮するモードを指定します。有効値:

  • AutoSpeed:ビデオが自動的に高速化されます。

TrackExpandMode

String

いいえ

現在のビデオトラックの長さがメイントラックの長さより短い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に延長されます。このパラメーターは、トラックを延長するモードを指定します。有効値:

  • AutoSpeed:ビデオが自動的に低速化されます。

VideoTrackClips

VideoTrackClip[]

はい

ビデオトラック内の素材です。

AudioTrack

音声のみの素材と、オーディオストリームを含む動画素材を配置します。

パラメーター

タイプ

必須

説明

MainTrack

Boolean

いいえ

現在のオーディオトラックがメイントラックであるかどうかを指定します。デフォルト値:False。詳細については、「メイントラックの設定」をご参照ください。

TrackShortenMode

String

いいえ

現在のオーディオトラックの長さがメイントラックの長さより長い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に短縮されます。このパラメーターは、トラックを短縮するモードを指定します。有効値:

  • AutoSpeed:オーディオが自動的に高速化されます。

TrackExpandMode

String

いいえ

現在のオーディオトラックの長さがメイントラックの長さより短い場合、現在のトラックの長さは、メイントラックの長さに合わせて適応的に延長されます。このパラメーターは、トラックを延長するモードを指定します。有効値:

  • AutoSpeed:オーディオが自動的に低速化されます。

AudioTrackClips

AudioTrackClip[]

はい

オーディオトラック内の素材です。

ImageTrack

重要

イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。

画像素材を配置します。

パラメーター

タイプ

必須

説明

ImageTrackClips (イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。)

ImageTrackClip[]

はい

イメージトラック内の素材です。

SubtitleTrack

バナーテキストや外部字幕などの字幕を配置します。

パラメーター

タイプ

必須

説明

SubtitleTrackClips

SubtitleTrackClip[]

はい

字幕トラック内の素材です。

EffectTrack

ビデオにフィルターや視覚効果を追加します。

パラメーター

タイプ

必須

説明

EffectTrackItems

EffectTrackItem[]

はい

エフェクトトラックに追加されるフィルターとエフェクトです。

VideoTrackClip

ビデオトラックに動画または画像素材を追加できます。

`In`、`Out`、`TimelineIn`、`TimelineOut` パラメーターを使用して、素材をカットしてタイムラインに追加する位置を指定できます。たとえば、`In` を 5、`Out` を 10、`TimelineIn` を 15、`TimelineOut` を 20 に設定すると、素材の 5 秒目から 10 秒目がカットされ、タイムラインの 15 秒目から 20 秒目に再生されます。

パラメーター

タイプ

必須

説明

MediaId

String

いいえ

ビデオトラック内の素材が対応する Intelligent Media Services (IMS) または ApsaraVideo VOD メディアアセットの ID です。

注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

MediaURL

String

いいえ

ビデオトラック内の素材の Object Storage Service (OSS) URL です。OSS URL の形式は次のとおりです:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

注意事項:

  • `MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

  • このパラメーターには、パブリック OSS URL またはインターネット経由でアクセス可能なパブリック URL を指定できます。

詳細については、「画像とビデオの編集」をご参照ください。

Type

String

いいえ

素材のタイプです。デフォルト値:Video。

有効値:

  • Video

  • Image

  • GlobalImage:グローバル画像です。グローバル画像の長さはビデオトラックの長さと同じです。`GlobalImage` の詳細については、「画像とビデオの編集」をご参照ください。

X

Float

いいえ

素材の左上隅と出力ビデオの左上隅との間の水平距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Y

Float

いいえ

素材の左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Width

Float

いいえ

出力ビデオ内の素材の幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Height

Float

いいえ

出力ビデオ内の素材の高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

AdaptMode

String

いいえ

素材が自動的にサイズ変更されるモードです。このパラメーターは、ビューの幅と高さを指定した場合にのみ有効になります。素材は、ビューの幅と高さに基づいてスケーリングされます。有効値:

  • Contain:素材の元のアスペクト比に基づいて素材のサイズを変更します。

  • Cover:元のアスペクト比に基づいて素材のサイズを変更してビューを埋め、はみ出し部分をクロップします。オブジェクトのアスペクト比がビューと一致しない場合、オブジェクトはビューの幅と高さに基づいてクロップされます。

  • Fill (デフォルト):元のアスペクト比に基づいて素材のサイズを変更し、素材を引き伸ばしてビューを埋めます。オブジェクトはビューを完全に埋めます。オブジェクトのアスペクト比がビューと一致しない場合、オブジェクトはビューの幅と高さに基づいて引き伸ばされます。

In

Float

いいえ

ソースファイル内の素材の開始時間です。ソースファイルは、オーディオまたはビデオファイルである必要があります。単位:秒。値は小数点以下 4 桁まで正確です。`In` を指定しない場合、0 が使用されます。

Out

Float

いいえ

ソースファイル内の素材の終了時間です。ソースファイルは、オーディオまたはビデオファイルである必要があります。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定しない場合、素材はソースファイルの終了時に終了します。

MaxOut

Float

いいえ

素材の最大終了時間です。このパラメーターを指定すると、素材の終了時間は、ソースファイルの長さと `MaxOut` の値の小さい方になります。このパラメーターは、ソースファイルがオーディオまたはビデオファイルの場合にのみ有効です。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定すると、`MaxOut` は無効になります。詳細については、「複数のビデオセグメントのトリミングとマージ」をご参照ください。

Duration

Float

いいえ

素材の長さです。ほとんどの場合、このパラメーターは画像に使用されます。単位:秒。値は小数点以下 4 桁まで正確です。

DyncFrames

Int

いいえ

アニメーションスタンプのフレーム数です。このパラメーターは、ソースファイルがアニメーション画像の場合にのみ有効です。詳細については、「GIF スタンプの追加」をご参照ください。

TimelineIn

Float

いいえ

タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。

TimelineOut

Float

いいえ

タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。

Speed

Float

いいえ

素材の再生速度です。有効値:0.1 から 100。たとえば、このパラメーターを 2 に設定すると、素材は出力ビデオで元の速度の 2 倍で再生されます。この場合、素材の長さは半分に短縮されます。

詳細については、「オーディオとビデオの速度変更」をご参照ください。

Opacity

Float

いいえ

ビデオの不透明度です。有効値:0 から 1。値 0 はビデオが完全に透明であることを示します。値 1 はビデオが完全に不透明であることを示します。

MaskVideoUrl

String

いいえ

マスクファイルの URL です。ほとんどの場合、マスクファイルはアルファチャンネルを含むビデオです。アルファチャンネルを使用して、元のビデオに透明度情報を追加できます。

  • このパラメーターには、パブリック OSS URL またはインターネット経由でアクセス可能なパブリック URL を指定できます。

ClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。

詳細については、「素材と素材の長さの自動アライメント」をご参照ください。

ReferenceClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。

詳細については、「https://icms.alibaba-inc.com/content/ice/ims?l=1&m=65087&n=4406040」をご参照ください。

Effects

Effect[]

いいえ

素材に使用されるエフェクトです。

デジタルヒューマンビデオ

`VideoTrackClip` で `Type` を `AI_Avatar` に設定すると、編集用のデジタルヒューマンビデオを直接生成できます。詳細については、「インテリジェントタイムラインタスクの並列処理」をご参照ください。

説明

この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用可能です。

パラメーター

タイプ

必須

説明

備考

Type

String

はい

素材のタイプです。

  • 値を `AI_Avatar` に設定します。

MediaId

String

いいえ

デジタルヒューマンをレンダリングするために使用されるオーディオの ID です。

  • `MediaId`、`MediaURL`、`Content` のいずれか 1 つのみを指定する必要があります。

MediaURL

String

いいえ

デジタルヒューマンをレンダリングするために使用されるオーディオファイルの URL です。

  • `MediaId`、`MediaURL`、`Content` のいずれか 1 つのみを指定する必要があります。

  • このパラメーターには、パブリック OSS URL またはインターネット経由でアクセス可能なパブリック URL を指定できます。

Content

String

いいえ

デジタルヒューマンをレンダリングするために使用されるテキストコンテンツです。

  • `MediaId`、`MediaURL`、`Content` のいずれか 1 つのみを指定する必要があります。

  • このパラメーターの値は、5 文字以上である必要があります。

AvatarId

String

いいえ

デジタルヒューマン画像の ID です。

Voice

String

いいえ

音声のタイプです。

  • このパラメーターは `Content` を指定した場合に有効になります。

  • 音声エフェクトについては、「インテリジェント音声デモ」をご参照ください。

CustomizedVoice

String

いいえ

パーソナライズされた人間の声です。

  • 人間の音声クローニング機能を使用してトレーニングされた音声の ID を指定します。パーソナライズされた人間の声を使用してオーディオを生成できます。

  • このパラメーターを指定すると、`Voice` は無効になります。

LoopMotion

Boolean

いいえ

ビデオの最初と最後のフレームが同じであるかどうかを指定します。

  • このパラメーターを true に設定すると、デジタルヒューマン用に生成されたビデオの最初と最後のフレームが同じになります。これにより、ループ再生中やデジタルヒューマンビデオがマージされた際の、デジタルヒューマンの動きや表情のフレームジャンプを防ぎます。

  • 有効値:true および false。

  • デフォルト値:false。

SpeechRate

Integer

いいえ

話速です。

  • このパラメーターは `Content` を指定した場合に有効になります。有効値:-500 から 500。デフォルト値:0。

    • 値 -500 は、話速が元の話速の 0.5 倍であることを示します。値 0 は、元の話速が使用されることを示します。値 500 は、話速が元の話速の 2 倍であることを示します。

説明

次の例は、話速の計算方法を示しています:

  • 0.8:(1-1/0.8)/0.002 = -125

  • 1.2:(1-1/1.2)/0.001 = 166

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

速度が 1x より大きい場合は、係数 0.001 を使用します。

実際の計算結果は、最も近い整数に丸められます。

PitchRate

Integer

いいえ

イントネーションです。

  • このパラメーターは `Content` を指定した場合に有効になります。

  • 有効値:-500 から 500。

  • デフォルト値:0。

説明

デジタルヒューマンビデオの他のタイムラインパラメーターは、`VideoTrackClip` のタイムラインパラメーターと同じです。詳細については、このトピックの「VideoTrackClip」セクションをご参照ください。

AudioTrackClip

オーディオトラックには、音声のみの素材、オーディオストリームを含む動画素材、テキストから変換されたオーディオ素材を追加できます。

`In`、`Out`、`TimelineIn`、`TimelineOut` パラメーターを使用して、素材をカットしてタイムラインに追加する位置を指定できます。たとえば、`In` を 5、`Out` を 10、`TimelineIn` を 15、`TimelineOut` を 20 に設定すると、素材の 5 秒目から 10 秒目がカットされ、タイムラインの 15 秒目から 20 秒目に再生されます。

説明

同じオーディオトラック内のオーディオ素材の再生時間は、タイムライン上で重複できません。重複した場合、オーディオエラーが発生する可能性があります。

音声のみの素材またはオーディオストリームを含む動画素材

パラメーター

タイプ

必須

説明

MediaId

String

いいえ

オーディオトラック内の素材が対応する IMS または ApsaraVideo VOD メディアアセットの ID です。

注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

MediaURL

String

いいえ

オーディオトラック内の素材の OSS URL です。OSS URL の形式は次のとおりです:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

注意事項:

  • `MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

  • このパラメーターには、パブリック OSS URL またはインターネット経由でアクセス可能なパブリック URL を指定できます。

詳細については、「画像とビデオの編集」をご参照ください。

In

Float

いいえ

ソースファイル内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`In` を指定しない場合、0 が使用されます。

Out

Float

いいえ

ソースファイル内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`Out` を指定しない場合、素材はソースファイルの終了時に終了します。

TimelineIn

Float

いいえ

タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。

TimelineOut

Float

いいえ

タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。

Speed

Float

いいえ

素材の再生速度です。有効値:0.1 から 100。たとえば、このパラメーターを 2 に設定すると、素材は出力オーディオで元の速度の 2 倍で再生されます。この場合、素材の長さは半分に短縮されます。

詳細については、「オーディオとビデオの速度変更」をご参照ください。

Effects

Effect[]

いいえ

素材に使用されるエフェクトです。

LoopMode

Boolean

いいえ

タイムライン内の素材のループ再生を有効にするかどうかを指定します。True:ループ再生を有効にします。False (デフォルト):ループ再生を無効にします。

詳細については、「オーディオループ再生の設定」をご参照ください。

ClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。

詳細については、「素材と素材の長さの自動アライメント」をご参照ください。

ReferenceClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。

詳細については、「素材と素材の長さの自動アライメント」をご参照ください。

テキストから変換されたオーディオ素材

タイムラインのサンプルに関する詳細については、「テキストをオーディオに変換してビデオに追加」をご参照ください。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用可能です。

パラメーター

タイプ

必須

説明

Type

String

はい

素材のタイプです。値を `AI_TTS` に設定します。

Content

String

はい

テキストコンテンツです。

Voice

String

いいえ

音声のタイプです。詳細については、「インテリジェント音声デモ」をご参照ください。

CustomizedVoice

String

いいえ

  • パーソナライズされた人間の声です。

  • 人間の音声クローニング機能を使用してトレーニングされた音声の ID を指定します。パーソナライズされた人間の声を使用してオーディオを生成できます。

  • このパラメーターを指定すると、`Voice` は無効になります。

Format

String

いいえ

ファイルの形式です。有効値:pcm、wav、mp3。デフォルト値:mp3。

SpeechRate

Int

いいえ

話速です。有効値:-500 から 500。デフォルト値:0。

  • 値 -500 は、話速が元の話速の 0.5 倍であることを示します。値 0 は、元の話速が使用されることを示します。値 500 は、話速が元の話速の 2 倍であることを示します。デフォルトでは、モデルの出力話速は 1x です。話速は話者によって異なります。ほとんどの場合、話者は 1 秒あたり 4 文字を話します。

説明

次の例は、話速の計算方法を示しています:

  • 0.8:(1-1/0.8)/0.002 = -125

  • 1.2:(1-1/1.2)/0.001 = 166

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

速度が 1x より大きい場合は、係数 0.001 を使用します。

実際の計算結果は、最も近い整数に丸められます。

PitchRate

Int

いいえ

イントネーションです。有効値:-500 から 500。デフォルト値:0。

TimelineIn

Float

いいえ

タイムライン内の素材の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の再生が終了したときに再生を開始します。

TimelineOut

Float

いいえ

タイムライン内の素材の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の再生が開始したときに再生を停止します。

Effects

Effect[]

いいえ

素材に使用されるエフェクトです。

ClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ReferenceClipId` の値が設定されている場合、他のトラックの素材のタイムライン上の開始時間と終了時間は、現在の素材の開始時間と終了時間に揃えられます。

詳細については、「素材と素材の長さの自動アライメント」をご参照ください。

ReferenceClipId

String

いいえ

トラックアライメント値です。他のオーディオまたはビデオトラックの素材に同じ `ClipId` の値が設定されている場合、現在の素材のタイムライン上の開始時間と終了時間は、他のトラックの素材の開始時間と終了時間に揃えられます。

詳細については、「素材と素材の長さの自動アライメント」をご参照ください。

ImageTrackClip

重要

イメージトラック機能はビデオトラック機能に統合されたため、イテレーションやメンテナンスは行われなくなりました。

イメージトラックに画像素材を追加できます。

パラメーター

タイプ

必須

説明

MediaId

String

いいえ

イメージトラック内の素材が対応する IMS または ApsaraVideo VOD メディアアセットの ID です。

注意:`MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

MediaURL

String

いいえ

イメージトラック内の素材の OSS URL です。OSS URL の形式は https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4 です。

注意事項:

  • `MediaId` と `MediaURL` のいずれか一方のみを指定する必要があります。

  • このパラメーターにはパブリック OSS URL のみを指定できます。

詳細については、「オーディオとビデオの速度変更」をご参照ください。

X

Float

いいえ

素材の左上隅と出力ビデオの左上隅との間の水平距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Y

Float

いいえ

素材の左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Width

Float

いいえ

出力ビデオ内の素材の幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Height

Float

いいえ

出力ビデオ内の素材の高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

TimelineIn

Float

いいえ

タイムライン内の画像の開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、0 が使用されます。

TimelineOut

Float

いいえ

タイムライン内の画像の終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、ビデオトラックの最大長が使用されます。

DyncFrames

Int

いいえ

アニメーションスタンプのフレーム数です。ソースファイルがアニメーション画像の場合、このパラメーターは必須です。詳細については、「ウォーターマーク、スタンプ、または GIF スタンプの追加」をご参照ください。

Effects

Effect[]

いいえ

素材に使用されるエフェクトです。

SubtitleTrackClip

字幕トラックに字幕素材を追加できます。

説明

同じ字幕トラック内の字幕素材の再生時間は、タイムライン上で重複できません。重複した場合、字幕エラーなどの問題が発生する可能性があります。

パラメーター

タイプ

必須

説明

Type

String

はい

字幕素材のタイプです。有効値:

SubType

String

いいえ

字幕素材のサブタイプです。有効値:

  • srt:SubRip Subtitle (SRT) 形式の外部字幕ファイル

  • ass:Advanced SubStation Alpha (ASS) 形式の外部字幕ファイル

`Type` を `Text` に設定した場合は、このパラメーターを無視してください。

FileURL

String

いいえ

字幕ファイルの OSS URL です。`Type` を `Subtitle` に設定した場合、このパラメーターは必須です。OSS URL の形式は次のとおりです:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt

注意事項:

  • このパラメーターには、パブリック OSS URL またはインターネット経由でアクセス可能なパブリック URL を指定できます。

詳細については、「字幕と字幕テンプレート」をご参照ください。

X

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の水平距離です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Y

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の垂直距離です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

TimelineIn

Float

いいえ

タイムライン内のバナーテキストの開始時間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、素材はタイムライン内の前の素材の表示が終了したときに表示を開始します。

TimelineOut

Float

いいえ

タイムライン内のバナーテキストの終了時間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、素材はタイムライン内の次の素材の表示が開始したときに表示を停止します。

ClipId

Float

いいえ

このパラメーターはトラックの配置に使用されます。別のトラックの素材の `ReferenceClipId` が同じ値に設定されている場合、その素材の開始時間と終了時間は現在のクリップに揃えられます。

このパラメーターを指定する場合は、現在のクリップに `TimelineIn` と `TimelineOut` を指定するか、適応的なスクロール時間を有効にする必要があります。

ReferenceClipId

String

いいえ

このパラメーターはトラックの配置に使用されます。別のトラックの素材の `ClipId` が同じ値に設定されている場合、現在のクリップの開始時間と終了時間はその素材に揃えられます。

Content

String

いいえ

バナーテキストです。`Type` を `Text` に設定した場合、このパラメーターは必須です。

Font

String

いいえ

バナーテキストのフォントです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:SimSun。サポートされているフォントの詳細については、「フォントリスト」をご参照ください。

FontSize

Int

いいえ

バナーテキストのフォントサイズです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:0。最大値:5000。

SizeRequestType

String

いいえ

バナーテキストのレンダリングされたフォントのサイズの計算方法です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:RealDim。

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

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

FontColor

String

いいえ

バナーテキストの色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。

FontColorOpacity

Float

いいえ

バナーテキストの不透明度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。有効値:0 から 1。デフォルト値:1。値 1 はテキストが完全に不透明であることを示します。値 0 はテキストが完全に透明であることを示します。

FontFace

FontFace

いいえ

バナーテキストの外観です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。

Spacing

Int

いいえ

バナーテキストの単語間隔です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。

LineSpacing

Int

いいえ

バナーテキストの行間です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。

Angle

Float

いいえ

バナーテキストの反時計回りの回転角度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:度。デフォルト値:0。

BorderStyle

Int

いいえ

バナーテキストの境界線スタイルです。有効値:1 および 3。値 1 はテキストに境界線と影があることを示します。値 3 はテキストに背景があることを示します。デフォルト値:1。

Outline

Int

いいえ

バナーテキストの輪郭の幅です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。

OutlineColour

String

いいえ

バナーテキストの輪郭の色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。

Shadow

Int

いいえ

バナーテキストの影のサイズです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:ピクセル。デフォルト値:0。

BackColour

String

いいえ

バナーテキストの影の色です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。

Alignment

String

いいえ

テキスト配置モードです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。デフォルト値:TopLeft。有効値:

  • TopLeft

  • TopCenter

  • TopRight

  • CenterLeft

  • CenterCenter

  • CenterRight

  • BottomLeft

  • BottomCenter

  • BottomRight

異なる配置モードで字幕の正確な位置を指定したい場合は、次のようにテキスト配置を設定することを推奨します:

  • 左揃え:X と Y に、ビデオの左上隅に対する字幕の左上頂点の座標を指定します。

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

  • 右揃え:X と Y に、ビデオの左上隅に対する字幕の右上頂点の座標を指定します。

AdaptMode

String

いいえ

バナーテキストがビデオ幅または指定されたテキストボックス幅を超えた場合に、自動改行または自動スケーリングを有効にするかどうかを指定します。有効値:

  • AutoWrap:自動改行を有効にします。

  • AutoScale:自動スケーリングを有効にします。

  • AutoWrapAtSpaces:自動改行を有効にし、スペースの位置でのみテキストを折り返します。このオプションは英語のテキストにのみ適用されます。

  • AutoWrapAtSpacesStrict:スペース文字に基づいて厳密なワードラップを強制します。単語がコンテナの境界を超えた場合、単語は分割されずに次の行に移動します。

TextWidth

Float

いいえ

テキストボックスの幅です。このパラメーターは `AdaptMode` を指定した場合に有効になります。このパラメーターは、自動改行または自動スケーリングを有効にする場合に使用されます。このパラメーターを指定しない場合、自動改行または自動スケーリングにはビデオ幅が使用されます。値が 0 より大きく 1 以下の場合、値は出力ビデオの幅に対するテキストボックスの幅のパーセンテージを示します。値が 1 より大きい場合、値はピクセル数を示します。

FontUrl

String

いいえ

フォントファイルの OSS URL です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。サポートされているフォントファイルの形式は、TTF、OTF、WOFF です。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf。

EffectColorStyle

String

いいえ

バナーテキストのワードアート効果です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。ワードアート効果の詳細については、「ワードアート」をご参照ください。

SubtitleEffects

SubtitleEffect[]

いいえ

バナーテキストの多層エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。多層輪郭、多層の影、ガウスぼかし、字幕背景エフェクトを設定できます。ガウスぼかしは、字幕テキストに影が設定されている場合にのみサポートされます。

注意事項:

  • `SubtitleEffects` を指定すると、`SubtitleTrackClip` の `Outline` と `Shadow` は無効になります。

  • 多層輪郭、多層の影、または字幕背景エフェクトを設定した場合、字幕エフェクトは `SubtitleEffects` 配列要素のシーケンスに基づいて重ね合わせられます。配列の最初の字幕エフェクトに対応するレイヤーが最下層に配置され、最後の字幕エフェクトに対応するレイヤーが最上層に配置されます。

EnableLocalStyleAutoScale

Boolean

いいえ

字幕のローカルスタイルを設定する際に、ローカルスタイルのフォントサイズ、ストロークサイズ、影のサイズを出力ビデオサイズと FECanvas サイズに合わせてスケーリングするかどうか。デフォルト値は False で、ローカルスタイルはスケーリングされません。

SupportBidi

Boolean

いいえ

双方向テキストレンダリングを有効にするかどうか。字幕テキストに左から右へのテキスト (LTR、英語、数字、ラテン文字など) と右から左へのテキスト (RTL) の両方が含まれている場合に有効にすることを推奨します。デフォルトでは無効です。

ScrollStartY

Float

いいえ

字幕を上下にスクロールする開始点の y 座標値です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollEndY

Float

いいえ

字幕を上下にスクロールする終了点の y 座標値です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollSpeed

Float

いいえ

字幕が上下にスクロールする速度です。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位:ピクセル/秒。

ScrollStartShift

Float

いいえ

開始点に対する垂直スクロール位置のオフセットです。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollEndShift

Float

いいえ

終了点に対する垂直スクロール位置のオフセットです。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollStartFreeze

Float

いいえ

垂直スクロールの開始点での一時停止時間です。単位:秒。

ScrollEndFreeze

Float

いいえ

垂直スクロールの終了点での一時停止時間です。単位:秒。

ScrollDirection

String

いいえ

水平スクロールの方向です。有効値:

  • Left

  • Right

ScrollStartX

Float

いいえ

水平スクロールの開始点の x 座標値です。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollEndX

Float

いいえ

水平スクロールの終了点の x 座標値です。単位:ピクセル。値が 1 未満の場合は、出力ビデオの高さに対する相対的な尺度を表します。

ScrollLoop

Boolean

いいえ

水平スクロール効果をループさせるかどうかを指定します。

AaiMotionInEffect

String

いいえ

バナーテキストの開始エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。字幕の開始エフェクトの詳細については、「字幕エフェクトの例」をご参照ください。

AaiMotionIn

Float

いいえ

バナーテキストの開始エフェクトの長さです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`AaiMotionIn` を指定しない場合、デフォルトの長さ 0.5 秒が使用されます。テキストの表示時間が 0.5 秒未満の場合、開始エフェクトの長さはテキストの全長から終了エフェクトの長さを引いたものになります。

AaiMotionOutEffect

String

いいえ

バナーテキストの終了エフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。字幕の終了エフェクトの詳細については、「字幕エフェクトの例」をご参照ください。

AaiMotionOut

Float

いいえ

バナーテキストの終了エフェクトの長さです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。単位:秒。値は小数点以下 4 桁まで正確です。`AaiMotionOut` を指定しない場合、デフォルトの長さ 0.5 秒が使用されます。テキストの表示時間が 0.5 秒未満の場合、終了エフェクトの長さはテキストの全長になります。

AaiMotionLoopEffect

String

いいえ

バナーテキストのループエフェクトです。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。ループエフェクトは、開始エフェクトまたは終了エフェクトと同時に有効にすることはできません。テキストのループエフェクトの詳細については、「字幕エフェクトの例」をご参照ください。

Ratio

Float

いいえ

バナーテキストのループエフェクトの速度です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、1 が使用されます。1 より大きい値は速度が速いことを示し、1 未満の値は速度が遅いことを示します。

TextureURL

String

いいえ

バナーテキストのテクスチャの URL です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。PNG、JPG、JPEG、または BMP 形式の OSS オブジェクトのみがサポートされています。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png。

BubbleStyleId

String

いいえ

バナーテキストのバブルエフェクト ID です。このパラメーターは、`Type` を `Text` に設定した場合に有効になります。バブルエフェクトの詳細については、「テキストバブルエフェクトの例」をご参照ください。

BubbleWidth

Float

いいえ

出力ビデオに対するバブルベースマップの幅です。このパラメーターは、バブル字幕を使用する場合にのみ有効になります。1 より大きい値はピクセル数を示します。1 以下の値はパーセンテージを示します。

BubbleHeight

Float

いいえ

出力ビデオに対するバブルベースマップの高さです。このパラメーターは、バブル字幕を使用する場合にのみ有効になります。1 より大きい値はピクセル数を示します。1 以下の値はパーセンテージを示します。

EffectTrackItem

エフェクトトラックに視覚効果とフィルターを追加できます。

パラメーター

タイプ

必須

説明

Type

String

はい

エフェクトのタイプです。有効値:VFX および Filter。

SubType

String

はい

エフェクトのサブタイプです。

TimelineIn

Float

いいえ

タイムライン内のエフェクトの開始時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineIn` を指定しない場合、0 が使用されます。

TimelineOut

Float

いいえ

タイムライン内のエフェクトの終了時間です。単位:秒。値は小数点以下 4 桁まで正確です。`TimelineOut` を指定しない場合、エフェクトはビデオの終了時に終了します。

Duration

Float

いいえ

タイムライン内のエフェクトの長さです。単位:秒。値は小数点以下 4 桁まで正確です。`Duration` を指定しない場合、ビデオの長さが使用されます。

`Duration` と `TimelineOut` を同時に指定することはできません。

X

Float

いいえ

このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。エフェクトエリアの左上隅と出力ビデオの左上隅との間の水平距離です。

値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Y

Float

いいえ

このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。

エフェクトエリアの左上隅と出力ビデオの左上隅との間の垂直距離です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Width

Float

いいえ

このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。出力ビデオ内のエフェクトエリアの幅です。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Height

Float

いいえ

このパラメーターは、`SubType` を `mosaic_rect/blur` に設定した場合にのみ有効になります。出力ビデオ内のエフェクトエリアの高さです。値はパーセンテージまたはピクセル数で設定できます。値の範囲が 0 から 0.9999 の場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

SubtitleEffect

字幕トラックに輪郭や影を追加できます。

パラメーター

タイプ

必須

説明

Type

String

はい

エフェクトのタイプです。有効値:Outline、Shadow、Box。

Bord

Float

いいえ

輪郭または影の幅または高さです。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な幅または高さを示します。

XBord

Float

いいえ

輪郭または影の幅です。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な幅を示します。このパラメーターの優先度は `Bord` より低いです。

YBord

Float

いいえ

輪郭または影の高さです。1 より大きい値はピクセル数を示します。0 より大きく 1 未満の値は、テキストサイズに対する相対的な高さを示します。このパラメーターの優先度は `Bord` より低いです。

Shift

Float

いいえ

輪郭または影の水平または垂直オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的なオフセットを示します。このパラメーターには負の数を設定でき、負の数は上または左へのオフセットを示します。

XShift

Float

いいえ

輪郭または影の水平オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的な水平オフセットを示します。このパラメーターの優先度は `Shift` より低いです。

YShift

Float

いいえ

輪郭または影の垂直オフセットです。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 未満の場合は、テキストサイズに対する相対的な垂直オフセットを示します。このパラメーターの優先度は `Shift` より低いです。

Color

String

いいえ

RGB カラーです。値は、シャープ記号 (#) と 16 進数値の形式です。例:#ffffff。

Opacity

String

いいえ

字幕の不透明度です。値 1 は字幕が完全に不透明であることを示します。値 0 は字幕が完全に透明であることを示します。

Blur

Float

いいえ

ピクセル単位のガウスぼかし範囲です。このパラメーターは、`Type` を `Shadow` に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕の輪郭がグローします。

Radius

Float

いいえ

テキストの単色背景の角丸半径です。このパラメーターは、`Type` を `Box` に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕の背景が角丸になります。

ImageUrl

String

いいえ

カスタム字幕背景画像の URL です。このパラメーターは、`Type` を `Box` に設定した場合にのみ有効になります。このパラメーターを設定すると、カスタムバブル効果を実装できます。`BubbleWidth` または `BubbleHeight` を使用して字幕のサイズを変更できます。PNG、JPG、JPEG、または BMP 形式の OSS オブジェクトのみがサポートされています。例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png。

Width

Float

いいえ

ソースバブルベースマップの幅です。カスタムバブル字幕を使用する場合、このパラメーターは必須です。

Height

Float

いいえ

ソースバブルベースマップの高さです。カスタムバブル字幕を使用する場合、このパラメーターは必須です。

TextArea

String

いいえ

バブルベースマップ内のテキストエリアです。カスタムバブル字幕を使用する場合、このパラメーターは必須です。テキストエリアには、値が 0 から 1 の範囲の 4 つの浮動小数点数が含まれ、浮動小数点数はカンマ (,) で区切られます。たとえば、`0.1,0.2,0.8,0.6` と指定した場合、バブルに対するテキストボックスの左上隅の座標は 0.1 と 0.2 で、バブルに対するテキストボックスの幅と高さは 0.8 と 0.6 になります。

FontFace

次の表に、フォントスタイルパラメーターを示します。

パラメーター

タイプ

必須

説明

Bold

Boolean

いいえ

フォントが太字であるかどうかを指定します。

Italic

Boolean

いいえ

フォントが斜体であるかどうかを指定します。

Underline

Boolean

いいえ

フォントに下線が付いているかどうかを指定します。

Effect

素材エフェクト

次のパラメーターを設定してエフェクトを定義します。一部のパラメーターは複数のエフェクトタイプで共有されます。

エフェクトパラメーターの詳細については、「エフェクト設定」をご参照ください。

次の表に、エフェクトの共通パラメーターを示します。

パラメーター

タイプ

必須

説明

Type

String

はい

エフェクトのタイプです。有効値:

  • Text:ビデオトラックの素材にバナーテキストを追加します。

  • DeWatermark:ビデオトラックの素材のウォーターマークをぼかします。

  • Crop:ビデオトラックの素材をクロップします。

  • Pad:ビデオトラックの素材にパディングを追加します。

  • Scale:ビデオトラックの素材をスケーリングします。

  • Transition:ビデオトラックの素材にトランジションエフェクトを追加します。

  • VFX:ビデオトラックの素材に視覚効果を追加します。

  • Volume:オーディオトラックの素材の音量を調整します。

  • AFade:オーディオトラックの素材にオーディオのフェードインとフェードアウトを設定します。

  • AI_ASR:オーディオまたはビデオトラックのオーディオから字幕を生成します。

SubType

String

いいえ

エフェクトのサブタイプです。

  • `Type` を `Transition` に設定した場合、このパラメーターはトランジションエフェクトのサブタイプを指定します。

  • `Type` を `VFX` に設定した場合、このパラメーターは視覚効果のサブタイプを指定します。

  • `Type` を `Filter` に設定した場合、このパラメーターはフィルター効果のサブタイプを指定します。詳細については、「フィルターの例」をご参照ください。