Intelligent Media Services:パブリックパラメーター

パラメーター

タイプ

説明

例

必須

Level

Integer

小見出しのレベル。

列挙値：1、2、3、4、5。

1

はい

TitleArray

List<String>

小見出しの配列。制作ごとに 1 つがランダムに選択されます。

最大 50 個のタイトルを指定できます。各タイトルは最大 50 文字です。

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

はい

パラメーター

タイプ

説明

例

必須

MediaId

String

ステッカー、ロゴ、ウォーターマーク、またはその他の画像アセットの ID。

****b4545fg6c88681030f6e****

はい (MediaId または MediaURL のいずれかを選択)。両方を指定した場合は 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

いいえ

パラメーター

タイプ

説明

例

必須

Volume

String

入力動画の音量。値の範囲：[0, 10.0]。小数点以下 2 桁まで指定可能。

0.5

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

MediaMetaDataArray

List<MediaMetaData>

メディアメタデータオブジェクトのリスト。

MediaMetaDataをご参照ください。

いいえ

パラメーター

タイプ

説明

例

必須

Media

String

メディアアセット ID または OSS URL。InputConfig で提供されるアセットと一致する必要があります。

53fg5f9d46c88b******0f6etft6

はい

GroupName

String

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

group1

このパラメーターは Script-to-Video モードでのみ有効です。他の制作モードでは使用しないでください。

TimeRangeList

List<TimeRange>

イン点とアウト点のリスト。各アセットに複数の時間範囲を指定でき、制作時にこれらの範囲からクリップが選択されます。

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

はい

Opacity

Float

アセットの不透明度。値の範囲：[0, 1]。

0.5

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

パラメーター

タイプ

説明

例

必須

In

Float

アセットのイン点 (秒単位)。小数点以下 4 桁までの精度です。

1.1233

はい

Out

Float

アセットのアウト点 (秒単位)。小数点以下 4 桁までの精度です。

2.4566

はい

パラメーター

タイプ

説明

例

必須

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

文字列

公式ボイスをカンマ区切りで 1 つ以上指定します。複数のボイスが指定した場合、1 つがランダムに選択されます。利用可能なボイスについては、インテリジェントボイスの例をご参照ください。

zhimiao_emo,zhilun

いいえ

SpeechRate

• 話速。値の範囲：-500 ～ 500。

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

100

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

Style

String

ナレーションスタイル。指定されたスタイルからランダムにボイスが選択されます。Voice と両方を設定した場合は Voice が優先されます。有効な値：

• "Gentle"：次を含みます。"zhiqi"、"zhijia"、"zhitian"、"zhiyan_emo"、"zhinan"、"zhichu"、"zhiyuan"。

• "Serious"：次を含みます。"zhiru"、"zhixiang"、"zhilun"、"zhifeng_emo"。

• "Entertainment"：次を含みます。"zhiqing"、"zhiwei"、"zhibei_emo"。

ボイスの例については、インテリジェントボイスの例をご参照ください。

Gentle

いいえ

CustomizedVoice

String

カスタムボイス。クローンボイスから ListCustomizedVoiceJobs を指定します (Standard バージョンと Public バージョンに対応)。設定した場合、Voice および Style は無視されます。

Voice-test1

いいえ

SpecialWordsConfig

JSON

字幕 (ナレーション) のローカル効果の設定で、ワードハイライトと NGワードフィルタリングをサポートします。このパラメーターは配列です。

[{"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：英語

zh

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

パラメーター

タイプ

説明

例

必須

Volume

String

BGM の音量。値の範囲：[0, 10.0]。小数点以下の桁数は 2 桁まで指定可能。

0.5

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

Style

String

BGM のスタイル。InputConfig で BGM がすでに設定されている場合、このフィールドは無効になります。有効な値：

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

• "bgm-chinese-style"：中国風

• "bgm-cuisine"：料理

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

• "bgm-quirky"：個性的

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

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

• "bgm-upbeat"：アップテンポ

bgm-beauty

いいえ

LoopMode

Boolean

BGM のループモード。有効な値：

• true：自動ループ。

• false：1 回再生後に停止。

true

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

AFadeOutDuration

Float

BGM のフェードアウト期間 (秒)。値の範囲： 0 から音楽トラックの長さまで。

2.0

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

パラメーター

タイプ

説明

例

必須

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

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 は相互に排他的です。両方を指定した場合、FontSize が優先されます。

24

いいえ

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

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

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

SizeRequestType

String

レンダリング時のフォントサイズの計算方法。

• Nominal：レンダリングされる高さ (ピクセル単位) は FontSize と等しくなります。

• RealDim：一部のフォントでは、レンダリングされる高さが FontSize よりも小さくなる場合があります。

Nominal

いいえ

Nominal

Nominal

Nominal

FixedFontSize

Int

フォントサイズ。このサイズは出力解像度に連動しません。

• FontSize と FixedFontSize は相互に排他的です。両方を指定した場合、FontSize が優先されます。

14

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

FixedX

Float

出力動画の左上隅からの水平距離。パーセンテージ (0 ～ 0.9999) とピクセル (2 以上) の両方で指定可能です。この座標は出力解像度に連動しません。

64

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

FixedY

Float

出力動画の左上隅からの垂直距離。パーセンテージ (0 ～ 0.9999) とピクセル (2 以上) の両方で指定可能です。この座標は出力解像度に連動しません。

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

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

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 を含む他のスタイルパラメーターが設定されている場合、これは無視されます。

CS0001-000001

いいえ

「スタイルセットのデフォルト」をご参照ください

「スタイルセットのデフォルト」をご参照ください

「スタイルセットのデフォルト」をご参照ください

SubtitleEffects

SubtitleEffect[]

テキストのマルチレイヤー効果。マルチレイヤーのボーダー、シャドウ、ガウスぼかし (シャドウ用)、および背景をサポートします。

• SubtitleEffects が設定されている場合、Outline と Shadow は無視されます。

• レンダリングレイヤーの順序は配列の順序で決まり、最初の要素が一番下になります。

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

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

AaiMotionInEffect

String

テキストオーバーレイのインアニメーション効果タイプ (カンマ区切り)。字幕効果の例をご参照ください。

blur_in,wave_in

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

AaiMotionIn

Float

インアニメーションの再生時間 (秒単位)。小数点以下 4 桁まで指定できます。デフォルトは 0.5 秒です。テキストの再生時間が 0.5 秒未満の場合、合計の再生時間からアウト再生時間を引いた値になります。

0.5

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

AaiMotionOutEffect

String

テキストオーバーレイのアウトアニメーション効果タイプ (カンマ区切り)。字幕効果の例をご参照ください。

blur_in,wave_in

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

AaiMotionOut

Float

アウトアニメーションの再生時間 (秒単位)。小数点以下 4 桁まで指定できます。デフォルトは 0.5 秒です。テキストの再生時間が 0.5 秒未満の場合、テキストの合計再生時間になります。

0.5

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

AaiMotionLoopEffect

String

テキストオーバーレイのループアニメーション効果タイプ (カンマ区切り)。イン/アウトアニメーションとは併用できません。字幕効果の例をご参照ください。

blur_in,wave_in

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

Ratio

Float

ループアニメーションの再生速度。小数点以下 4 桁まで指定できます。1 は標準速度です。1 より大きい値は加速を意味します。

1.2

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

TextureURL

String

テキストのテクスチャとして使用する画像 URL (OSS のみ)。PNG、JPG、JPEG、BMP をサポートします。

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

いいえ

デフォルト値なし

デフォルト値なし

デフォルト値なし

パラメーター

タイプ

説明

例

必須

BatchEditingTemplateIdArray

List<String>

• テンプレート ID のリスト (最大 50 個)。制作ごとに 1 つのテンプレートがランダムに選択される。

• 選択ルール：10 個のテンプレートがあり、20 本の動画をリクエストした場合、システムはランダムな開始インデックス (例：3) を選び、3、4、...、10、1、2、... のように循環して選択する。

• 処理ロジック：API 呼び出しで指定したパラメーターがテンプレートのパラメーターより優先されます。API 呼び出しでパラメーターを設定していない場合は、テンプレートの値が使用されます。

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

いいえ