この Topic では、映画ハイライトシナリオの構成パラメーター、詳細設定、およびソフトウェア開発キット (SDK) の呼び出し例について説明します。
自動スクリプトベースのビデオ生成とスマートコンテンツマッチングビデオ生成では、同じ API を使用してタスクを送信します。パラメーターを使用してそれらを区別する方法の詳細については、「パラメーターの違い」をご参照ください。
注: この API では、すべてのメディアアセットの Object Storage Service (OSS) URL で指定されたリージョンが、OpenAPI エンドポイントのリージョンと一致する必要があります。
サポートされているリージョン: 中国 (上海)、中国 (北京)、中国 (杭州)、中国 (深圳)、米国 (西部)、およびシンガポール。
例では、[your-bucket]、[your-region-id]、[your-file-name]、[your-file-path] などのプレースホルダー、およびメディアアセット ID (例: "****9d46c8b4548681030f6e****") を実際の値に置き換えてください。
この Topic をよりよく理解するために、「ワンクリックスマートビデオ生成のユーザーガイド」を読んで、映画ハイライトシナリオの概念とプロシージャについて学んでください。
映画ハイライトシナリオは、2 つのビデオ生成モードをサポートしています。この Topic では、次のモードについて詳しく説明します。
グローバルナレーションモード
ストーリーボードモード
使用上の注意
複数のビデオ、オーディオ、および画像アセットからバッチでビデオを生成するために使用される API の詳細については、「SubmitBatchMediaProducingJob - 一度に複数のスマートビデオを生成する」をご参照ください。主要な API パラメーターの詳細については、この Topic の後半にある InputConfig、EditingConfig、および OutputConfig パラメーターの説明をご参照ください。
バッチビデオ生成ジョブの詳細情報を取得するには、「GetBatchMediaProducingJob - バッチスマートビデオ生成ジョブに関する情報を取得する」をご参照ください。
InputConfig パラメーター
InputConfig を使用して、ビデオクリップ、ナレーション、バックグラウンドミュージック、ステッカーなどの基本アセットのパラメーターを指定します。
パラメーター | タイプ | 説明 | 例 | 必須 | サポートされているモード |
MediaArray | List<String> |
| ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"] | はい | 完全サポート |
TitleArray | List<String> | タイトルの配列。ビデオ生成ごとにランダムなタイトルが選択されます。 最大 50 個のタイトルを指定できます。各タイトルには最大 50 文字を含めることができます。 | ["Title 1","Title 2"] | いいえ | 完全サポート |
SubHeadingArray | List<SubHeading> | 字幕設定。 | [{"Level":1,"TitleArray":["Level-1 Subtitle 1","Level-1 Subtitle 2"]},{"Level":3,"TitleArray":["Level-3 Subtitle"]}] | いいえ | すべてのモード |
SpeechTextArray | List<String> |
| ["ナレーションコンテンツ 1","ナレーションコンテンツ 2"] | いいえ |
|
SceneInfo | シナリオ情報。シナリオ関連のパラメーターに使用されます。 | 詳細については、「パラメーター例: グローバルナレーションモード」および「パラメーター例: ストーリーボードモード」をご参照ください。 | はい |
| |
StickerArray | List<Sticker> |
| [{"MediaId":"****9d46c8b4548681030f6e****","X":10,"Y":100,"Width":300,"Height":300,"Opacity":0.6}] | いいえ | すべてのモード |
BackgroundMusicArray | List<String> |
| ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"] | いいえ | 完全サポート |
BackgroundImageArray | List<String> |
| ["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"] | いいえ | すべてのモード |
SceneInfo パラメーター
パラメーター | タイプ | 説明 | 必須 | サポートされているモード |
Scene | String | マッチングシナリオタイプ。映画ハイライトシナリオの場合、このパラメーターを静的フィールド "MovieHighlights" に設定します。 | はい |
|
ShotInfo | ストーリーボードを構成します。 | はい |
| |
FaceInfo | 顔情報を構成します。 | いいえ | 完全サポート |
ShotInfo パラメーター
このパラメーターはストーリーボードモードにのみ適用されます。グローバルナレーションモードでは、このパラメーターを設定する必要はありません。
パラメーター | タイプ | 説明 | 必須 |
ShotScripts | List<ShotScript> | ショットスクリプトの配列。 | はい |
ShotScript パラメーター
このパラメーターはストーリーボードモードにのみ適用されます。グローバルナレーションモードでは、このパラメーターを設定する必要はありません。
映画ハイライトシナリオのストーリーボードモードでは、テキスト説明モードと手動解析モードの 2 つのショットモードが利用可能です。パラメーターを設定する際に、これらのモードのいずれかを選択する必要があります。
パラメーター | タイプ | 説明 | 例 | 必須 | ショットモード |
ScriptText | String | 単一ショットのスクリプトテキスト。ショットの内容を説明します。ショットの内容を 1 文か 2 文で要約します。 | 地下鉄の車内で、林夏は隅に座り、静かに携帯電話で録画している。老婆が孫の手を握り、静かに歌を口ずさんでいる。 | いいえ | テキスト説明モード |
SpeechText | String |
| 深夜の車内は静かだが、歌声で車内全体を明るくする人もいる。 | いいえ | すべてのモード |
Duration | Float |
| 5 | いいえ | |
Descriptions | List<String> | 単一ショットの詳細な説明。ショットの内容を 1 文か 2 文で要約します。 | ["地下鉄の車内の隅に座り、静かに携帯電話で録画する林夏", "老婆が孫の手を握り、静かに歌を口ずさむ"] | いいえ | 手動解析モード |
Characters | List<String> | 単一ショットの登場人物 (顔) の名前。注: 登場人物名は FaceInfo.ImageInfoList の ImageInfo.Name と同じである必要があります。 | ["林夏", "老婆", "孫"] | いいえ | |
Settings | List<String> | 単一ショットのシーン説明。 | ["深夜の地下鉄車内"] | いいえ | |
Volume | Float |
| 0.5 | いいえ | 完全サポート |
FaceInfo パラメーター
パラメーター | タイプ | 説明 | 必須 |
ImageInfoList | List<ImageInfo> | 登場人物 (顔) の写真のリスト。リストには最大 200 枚の写真を含めることができます。 | いいえ |
ImageInfo パラメーター
パラメーター | タイプ | 説明 | 例 | 必須 |
Name | String | 登場人物 (顔) の名前。 | Daniel | はい |
ImageURL | String | 登場人物 (顔) の写真のストレージの場所。インターネット経由でアクセス可能な URL である必要があります。顔画像には 1 人の個人だけが含まれ、顔が鮮明で、大きな障害物や欠落部分がないことを確認してください。 | http://[your-cdn-domain]/[your-file-path]/face1.png | はい。2 つのパラメーターのうち 1 つを指定する必要があります。 |
ImageId | String | 画像メディアアセット ID。 | ****9d46c886b45481030f6e**** |
パラメーター例: グローバルナレーションモード
{
"MediaArray": [
"****9d46c886b45481030f6e****",
"****c886810b4549d4630f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.mp4",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test2.png"
],
"SceneInfo": {
"Scene": "MovieHighlights", // 映画ハイライトマッチング用の MovieHighlights
"FaceInfo": {
"ImageInfoList": [
{
"Name": "登場人物 A",
"ImageURL": "https://bkimg.cdn.bcebos.com/pic/3853ad1bdd9f70558718bf38?x-bce-process=image/format,f_auto/watermark,image_d2F0ZXIvYmFpa2UyNzI,g_7,xp_5,yp_5,P_20/resize,m_lfit,limit_1,h_1080"
},
{
"Name": "登場人物 B",
"ImageURL": "https://bkimg.cdn.bcebos.com/pic/622762d0f703918ffbedc1125b3d269759eec42e?x-bce-process=image/format,f_auto/watermark,image_d2F0ZXIvYmFpa2UyNzI,g_7,xp_5,yp_5,P_20/resize,m_lfit,limit_1,h_1080"
},
{
"Name": "登場人物 C",
"ImageId": "****b681034549d46c880f6e****"
}
]
}
},
"TitleArray": [
"回龍観の盒馬鮮生がオープンしました!",
"盒馬鮮生がオープンしました!"
],
"SubHeadingArray": [
{
"Level": 1,
"TitleArray": ["字幕 1", "字幕 2"]
},
{
"Level": 3,
"TitleArray": ["レベル 3 字幕"]
}
],
"SpeechTextArray": [
"近くのモールに新しい盒馬鮮生がオープンしました。今日はグランドオープンなので、急いで駆けつけました。この盒馬はあまり大きくありませんが、モールは満員です。スナックや飲み物はかなり安く、行列は信じられないほど長いです。ぜひ見に来てください!",
"近くのモールに新しい盒馬鮮生がオープンしました。今日はグランドオープンなので、急いで駆けつけました。"
],
"Sticker": {
"MediaId": "****b681034549d46c880f6e****",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300
},
"StickerArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300,
"Opacity": 0.6
},
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/test3.png",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300
}
],
"BackgroundMusicArray": [
"****b4549d46c88681030f6e****",
"****549d46c88b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test4.mp3"
],
"BackgroundImageArray": [
"****6c886b4549d481030f6e****",
"****9d46c8548b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png"
]
}パラメーター例: ストーリーボードモード
{
"MediaArray": [
"****9d46c886b45481030f6e****",
"****c886810b4549d4630f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.mp4",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test2.png"
],
"SceneInfo": {
"Scene": "MovieHighlights", // 映画ハイライトマッチング用の MovieHighlights
"ShotInfo": {
"ShotScripts": [
// テキスト説明モードの例の開始。各ショットについて、手動解析モードまたはテキスト説明モードのいずれかを選択します。
{
"ScriptText": "地下鉄の車内で、林夏は隅に座り、静かに携帯電話で録画している。老婆が孫の手を握り、静かに歌を口ずさんでいる。",
"SpeechText": "深夜の車内は静かだが、歌声で車内全体を明るくする人もいる。"
},
{
"ScriptText": "老婆の白髪が車内の照明の下で輝いている。彼女は孫の頭を撫で、'この歌を覚えているかい?'とささやく。",
"SpeechText": "彼女の世界はぼやけているかもしれないが、彼の前では、彼女はまだ最も優しい母親だ。"
},
{
"ScriptText": "林夏は撮影をやめ、窓の外で点滅する看板を見つめ、表情が和らぐ。",
"SpeechText": "他人の物語を記録していると思っていたが、静かに癒されていた。"
},
{
"ScriptText": "家で、林夏はカメラを取り出し、最初の日記を書く: '今日、私は幸せがどんなものかを見た。'",
"SpeechText": "時々、幸せは大きなことではなく、私たちが見過ごしている小さな瞬間にある。"
},
{
"ScriptText": "数日後、林夏のソーシャルメディアに投稿された一連の心温まる写真がネットユーザーの共感を呼ぶ。",
"SpeechText": "彼女はレンズで物語を語り始め、すべての物語には愛のかけらが込められている。"
},
{
"ScriptText": "夜、林夏は再び地下鉄の駅に入る。今回は笑顔で、新しい目標を持って。",
"SpeechText": "この街は大きいが、いつも誰かがあなたを待っていて、発見する価値のある誰かがいる。"
}
// テキスト説明モードの例の終了
// 手動解析モードの例の開始。各ショットについて、手動解析モードまたはテキスト説明モードのいずれかを選択します。
{
"Descriptions": ["地下鉄の車内の隅に座り、静かに携帯電話で録画する林夏", "老婆が孫の手を握り、静かに歌を口ずさむ"],
"Characters": ["林夏", "老婆", "孫"],
"Settings": ["深夜の地下鉄車内"],
"SpeechText": "深夜の車内は静かだが、歌声で車内全体を明るくする人もいる。"
},
{
"Descriptions": ["老婆の白髪が車内の照明の下で輝いている", "彼女は孫の頭を撫で、静かに話す"],
"Characters": ["老婆", "孫"],
"Settings": ["地下鉄車内"],
"SpeechText": "彼女の世界はぼやけているかもしれないが、彼の前では、彼女はまだ最も優しい母親だ。"
},
{
"Descriptions": ["林夏は撮影をやめる", "窓の外で点滅する看板を見つめ、表情が和らぐ"],
"Characters": ["林夏"],
"Settings": ["移動中の地下鉄車内"],
"SpeechText": "他人の物語を記録していると思っていたが、静かに癒されていた。"
},
{
"Descriptions": ["林夏は家でカメラを取り出す", "最初の日記を書く: '今日、私は幸せがどんなものかを見た'"],
"Characters": ["林夏"],
"Settings": ["モダンなアパート / 部屋"],
"SpeechText": "時々、幸せは大きなことではなく、私たちが見過ごしている小さな瞬間にある。"
},
{
"Descriptions": ["林夏のソーシャルメディアページに心温まる写真が投稿される", "ネットユーザーが次々と「いいね」やコメントをする"],
"Characters": ["林夏"],
"Settings": ["電話画面 / ソーシャルメディアインターフェイス"],
"SpeechText": "彼女はレンズで物語を語り始め、すべての物語には愛のかけらが込められている。"
},
{
"Descriptions": ["夜、林夏は地下鉄の駅に入る", "彼女は笑顔で、新しい目標を持っている"],
"Characters": ["林夏"],
"Settings": ["都市の地下鉄駅"],
"SpeechText": "この街は大きいが、いつも誰かがあなたを待っていて、発見する価値のある誰かがいる。"
}
// 手動解析モードの例の終了
// ナレーションを構成しないことも選択できます。ショットスクリプトとデュレーションのみを構成して、元のビデオサウンドを再生します。
{
"ScripText": "地下鉄の車内で、林夏は隅に座り、静かに携帯電話で録画している。老婆が孫の手を握り、静かに歌を口ずさんでいる。",
"Duration": 8.0, // ナレーションスクリプトがない場合に設定可能
"Volume": 1.0 // 元のビデオアセットのボリュームを設定
}
]
},
"FaceInfo": {
"ImageInfoList": [
{
"Name": "登場人物 A",
"ImageURL": "https://bkimg.cdn.bcebos.com/pic/3853ad1bdd9f70558718bf38?x-bce-process=image/format,f_auto/watermark,image_d2F0ZXIvYmFpa2UyNzI,g_7,xp_5,yp_5,P_20/resize,m_lfit,limit_1,h_1080"
},
{
"Name": "登場人物 B",
"ImageURL": "https://bkimg.cdn.bcebos.com/pic/622762d0f703918ffbedc1125b3d269759eec42e?x-bce-process=image/format,f_auto/watermark,image_d2F0ZXIvYmFpa2UyNzI,g_7,xp_5,yp_5,P_20/resize,m_lfit,limit_1,h_1080"
},
{
"Name": "登場人物 C",
"ImageId": "****b681034549d46c880f6e****"
}
]
}
},
"TitleArray": [
"回龍観の盒馬鮮生がオープンしました!",
"盒馬鮮生がオープンしました!"
],
"StickerArray": [
{
"MediaId": "****9d46c8b4548681030f6e****",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300
},
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/test3.png",
"X": 10,
"Y": 100,
"Width": 300,
"Height": 300,
"Opacity": 0.6
}
],
"BackgroundMusicArray": [
"****b4549d46c88681030f6e****",
"****549d46c88b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test4.mp3"
],
"BackgroundImageArray": [
"****6c886b4549d481030f6e****",
"****9d46c8548b4681030f6e****",
"http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png"
]
}EditingConfig パラメーター
EditingConfig を使用して、出力ビデオアセットのボリューム、位置、およびその他の構成パラメーターを指定します。特別な要件がない場合は、デフォルト構成を使用し、このフィールドは空のままにします。
パラメーターの説明は、映画ハイライトシナリオのグローバルナレーションモードとストーリーボードモードで同じです。
パラメーター | タイプ | 説明 | 例 | 必須 |
JSON | 入力ビデオアセットの構成。 | 詳細については、「パラメーター例」をご参照ください。 | いいえ | |
JSON | タイトルの構成。字幕パラメーターを構成できます。フィールドの詳細については、「バナーテキスト」をご参照ください。 | 詳細については、「パラメーター例」をご参照ください。 | いいえ | |
SubHeadingConfig | JSON | 複数レベルの字幕の構成。字幕パラメーターを設定できます。 JSON フィールドの説明: | 詳細については、「パラメーター例」をご参照ください。 | いいえ |
JSON | ナレーションスクリプトの構成。 | 詳細については、「パラメーター例」をご参照ください。 | いいえ | |
JSON | バックグラウンドミュージックの構成。 | {"Volume":0.2} | いいえ | |
JSON | 背景画像の構成。 | {"SubType":"Blur","Radius":0.5} | いいえ | |
リミックス処理構成。 | 詳細については、「パラメーター例」をご参照ください。 | いいえ | ||
JSON | フロントエンドページのプレビュー用のキャンバス構成。 | {"Width": 1080,"Height": 1920} | いいえ | |
ProduceConfig | JSON | 標準のビデオ編集および構成。フィールドの詳細については、「EditingProduceConfig」をご参照ください。 | {"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"***d54a97cff4108b555b01166d4b***","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false} | いいえ |
ProcessConfig パラメーター
パラメーター | タイプ | 説明 | 例 | 必須 |
AllowVfxEffect | ブール値 | 特殊効果を追加するかどうかを指定します。 | true | いいえ。デフォルト値: false。 |
VfxEffectProbability | Float | 各ビデオクリップに特殊効果を適用する確率。有効値: 0.0~1.0。小数点以下 2 桁までサポートされています。 | 0.6 | いいえ。デフォルト値: 0.5。 |
VfxFirstClipEffectList | List<String> |
| ["slightshow","starfieldshinee"] | いいえ |
VfxNotFirstClipEffectList | List<String> |
| ["zoomslight","zoom"] | いいえ |
AllowTransition | ブール値 | トランジションを追加するかどうかを指定します。 | true | いいえ。デフォルト値: false。 |
TransitionDuration | Float | トランジションのデュレーション (秒)。トランジションのデュレーションがクリップのデュレーションから 1 を引いた値より大きい場合、そのクリップのトランジションは有効になりません。 | 0.5 | いいえ。デフォルト値: 0.5s。 |
TransitionList | List<String> | カスタムトランジションのリスト。AllowTransition が true に設定されている場合、リストからランダムなトランジションが選択されて合成されます。利用可能なトランジションについては、「トランジションライブラリ」をご参照ください。このパラメーターが空の場合、"linearblur"、"colordistance"、"crosshatch"、"dreamyzoom"、"doomscreentransition_up" からランダムな効果が選択されます。 | ["directional", "linearblur"] | いいえ |
UseUniformTransition | ブール値 | 単一のビデオ全体で同じトランジションを使用するかどうかを指定します。 | true | いいえ。デフォルト値: true。 |
AllowFilter | ブール値 | カスタムフィルターを追加するかどうかを指定します。 | false | いいえ。デフォルト値: false。 |
FilterList | List<String> | カスタムフィルターのリスト。AllowFilter が true に設定されている場合、リストからランダムなフィルターが選択されて合成されます。利用可能なフィルターについては、「フィルター効果の例」をご参照ください。このパラメーターが空の場合、フィルターは追加されません。 | ["m1", "m2"] | いいえ |
AllowDuplicateMatch | ブール値 | マッチしたクリップを再利用できるかどうかを指定します。 | false | いいえ。デフォルト値: false。 |
EnableClipDetection: | ブール値 | ソースマテリアルでショット検出を実行するかどうかを指定します。これは映画ハイライトシナリオでのみ構成できます。自動ショット分割をサポートし、ショットタイプを識別します。オープニング/クロージングクレジット、広告、および黒い画面は最終的なビデオには含まれません。 | true | いいえ。デフォルト値: true。 |
EnableTemporalOpt | ブール値 | マッチング結果に対して時間的最適化を実行するかどうかを指定します。これは映画ハイライトシナリオでのみ構成できます。入力ショット情報またはナレーションスクリプトがソースビデオのコンテンツ順序とほぼ一致する場合は、これを true に設定することをお勧めします。 | true | いいえ。デフォルト値: false。 |
EnableSubtitleMatch | ブール値 | 光学文字認識 (OCR) および自動音声認識 (ASR) の結果に基づいて、ナレーションスクリプトとビデオフレームのマッチングを最適化します。
| true | いいえ。デフォルト値: false。 |
EditingConfig パラメーター例
EditingConfig のすべてのパラメーターはオプションです。次のコードはデフォルト構成を示しています。
{
"MediaConfig": {
"Volume": 0 // デフォルトでソースビデオをミュート
},
"TitleConfig": {
"Alignment": "TopCenter",
"AdaptMode": "AutoWrap",
"Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
"SizeRequestType": "Nominal",
"Y": 0.1, // 縦長ビデオのタイトルの Y 座標
"Y": 0.05, // 横長ビデオのタイトルの Y 座標
"Y": 0.08 // 正方形ビデオのタイトルの Y 座標
},
"SpeechConfig": {
"Volume": 1, // デフォルトでナレーションオーディオに元のボリュームを使用
"SpeechRate": 0,
"Voice": null,
"Style": null,
"CustomizedVoice": null, // 音声クローン voiceId。このフィールドが指定されている場合、Voice と Style は無効になります。
"AsrConfig": {
"Alignment": "TopCenter",
"AdaptMode": "AutoWrap",
"Font": "Alibaba PuHuiTi 2.0 65 Medium",
"SizeRequestType": "Nominal",
"Spacing": -1,
"Y": 0.8, // 縦長ビデオの字幕の Y 座標
"Y": 0.9, // 横長ビデオの字幕の Y 座標
"Y": 0.85 // 正方形ビデオの字幕の Y 座標
}
},
"SubHeadingConfig": {
"1": {
"Y": 0.3,
"FontSize": 40
},
"3": {
"Y": 0.5,
"FontSize": 30
}
},
"BackgroundMusicConfig": {
"Volume": 0.2, // デフォルトでバックグラウンドミュージックに 20% のボリュームを使用
"Style": null
},
"ProcessConfig": {
"AllowVfxEffect": false, // 特殊効果を追加するかどうかを指定します
"AllowTransition": false, // トランジションを追加するかどうかを指定します
"AllowDuplicateMatch": false, // スマートコンテンツマッチングモードで、マッチしたクリップを再利用できるかどうかを指定します
"EnableClipDetection": true, // ショット検出を実行するかどうかを指定します
"EnableTemporalOpt": true // 時間的最適化を実行するかどうかを指定します
}
}TemplateConfig パラメーター
TemplateConfig は、ワンクリックビデオ生成のテンプレートを設定するために使用される共通パラメーターです。詳細なパラメーターの説明と例については、「TemplateConfig パラメーター」をご参照ください。
OutputConfig パラメーター
OutputConfig を使用して、出力アドレス、命名規則、幅、高さ、生成するビデオの数などのパラメーターを指定します。
パラメーター | タイプ | 説明 | 例 | 必須 |
MediaURL | String | 出力ビデオアドレス。{index} プレースホルダーを含める必要があります。 | ルール: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 例: http://example.oss-[your-region-id].aliyuncs.com/example/example_{index}.mp4 | GeneratePreviewOnly が false で、出力ビデオが OSS に送信される場合に必須です。 |
StorageLocation | String | VOD に出力されるメディアアセットファイルのストレージの場所。 | ルール: [your-vod-bucket].oss-[your-region-id].aliyuncs.com 例: outin-****6c886b4549d481030f6e****.oss-[your-region-id].aliyuncs.com | GeneratePreviewOnly が false で、出力ビデオが VOD に送信される場合に必須です。 |
FileName | String | 出力ファイル名。{index} プレースホルダーを含める必要があります。 | ルール: [your-file-name]__{index}.mp4 例: example_{index}.mp4 | GeneratePreviewOnly が false で、出力ビデオが VOD に送信される場合に必須です。 |
GeneratePreviewOnly | ブール値 |
| false | いいえ。デフォルト値: false。 |
Count | Integer | 出力ビデオの数。
| 1 | いいえ。デフォルト値: 1。 |
Width | Integer | 出力ビデオの幅 (ピクセル単位)。 | 1080 | はい |
Height | Integer | 出力ビデオの高さ (ピクセル単位)。 | 1920 | はい |
JSONObject | Crf や Codec などの出力ビデオストリームの構成。 | {"Crf": 27} | いいえ |
パラメーター例
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly":false
}SDK 呼び出し例
前提条件
Intelligent Media Service (IMS) サーバーサイド SDK をインストール済みであること。詳細については、「準備」をご参照ください。
コード例
次の例は、グローバルナレーションモードの使用方法を示しています。
API リクエストパラメーターの詳細
詳細設定
詳細設定の詳細については、「バッチワンクリックビデオ生成のリミックスロジックと詳細設定」をご参照ください。
よくある質問
自動スクリプトベースのビデオ生成に関するよくある質問への回答については、「映画ハイライトのよくある質問」をご参照ください。