この Topic では、インテリジェントなワンクリック動画制作テンプレートの構成に関するパラメーターについて説明します。
注：このインターフェイスでは、すべてのメディア OSS URL のリージョンは、OpenAPI エンドポイントのリージョンと一致している必要があります。
サポートされているリージョン：中国 (上海)、中国 (北京)、中国 (杭州)、中国 (深圳)、米国 (西部)、シンガポール。
この機能を使用する際は、ドキュメント内の [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path]、メディア ID (例: "****9d46c8b4548681030f6e****") などのすべてのパラメーター例を、実際の値に置き換えてください。
使用方法
カスタムのワンクリック動画制作テンプレートは、AddTemplate - テンプレートの作成 を通じて作成できます。API パラメーターの詳細については、後述する「AddTemplate パラメーターの説明」をご参照ください。
単一のワンクリック動画制作テンプレートを取得できます: GetTemplate - テンプレート情報の取得
ワンクリック動画制作テンプレートのリストを取得できます: ListTemplates - 条件に合うテンプレートのリスト表示
AddTemplate パラメーターの説明
パラメーター | タイプ | 説明 | 値の例 | 必須 |
Name | String | テンプレート名 | batch-editing-template-1 | いいえ |
Type | String | テンプレートのタイプ。ワンクリック動画制作の場合、この値は BatchEditing である必要があります | BatchEditing | はい |
JSON | テンプレートの構成パラメーター | 「パラメーターの例」の Config をご参照ください | はい |
Config パラメーターの説明
パラメーター | タイプ | 説明 | 値の例 | 必須 |
JSON | ステッカーウォーターマーク、バックグラウンドミュージック、バックグラウンドイメージなどのパラメーターを構成するために使用します。 | 「パラメーターの例」の InputTemplateConfig をご参照ください | いいえ | |
JSON | タイトル、ナレーション、バックグラウンドミュージック、バックグラウンドイメージなどの編集パラメーターを構成するために使用します。 | 「パラメーターの例」の EditingTemplateConfig をご参照ください | いいえ | |
JSON | 解像度、出力ビデオストリームなどに関連する合成パラメーターを構成するために使用します。 | 「パラメーターの例」の OutputTemplateConfig をご参照ください | はい |
InputTemplateConfig パラメーターの説明
パラメーター | タイプ | 説明 | 値の例 | 必須 |
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****"] | いいえ |
EditingTemplateConfig パラメーターの説明
パラメーター | タイプ | 説明 | 値の例 | 必須 |
JSON | タイトル関連の構成。字幕パラメーターの構成をサポートします。 | 「TitleConfig の値の例」をご参照ください | いいえ | |
SubHeadingConfig | JSON | 複数レベルの字幕構成。字幕パラメーターの設定をサポートします。 JSON フィールドの説明: | {"1":{"Y":0.3,"FontSize":40},"3":{"Y":0.5,"FontSize":30}} | いいえ |
JSON | ナレーションスクリプトの構成。 重要 テンプレートは SpecialWordsConfig パラメーターの構成をサポートしていません | 「SpeechConfig の値の例」をご参照ください | いいえ | |
JSON | バックグラウンドミュージックの構成。 | 「BackgroundMusicConfig の値の例」をご参照ください | いいえ | |
JSON | バックグラウンドイメージの構成。InputTemplateConfig ですでにバックグラウンドイメージが構成されている場合、このフィールドは効果がありません。 | 「BackgroundImageConfig の値の例」をご参照ください | いいえ | |
JSON | フロントエンドページのプレビュー用のキャンバス構成。 | {"Width": 1080,"Height": 1920} | いいえ |
FECanvas パラメーターの説明
コンソール - 通常テンプレート の通常テンプレートのスタイルをワンクリック動画制作テンプレートに移行する場合、プレビューの字幕サイズが実際の合成サイズと一致するように、通常テンプレートから FECanvas パラメーターとタイトルおよび字幕の スタイル構成 をコピーし、ワンクリック動画制作テンプレートの TitleConfig、SpeechConfig.AsrConfig、および FECanvas に割り当てる必要があります。
パラメーター | タイプ | 説明 | 値の例 | 必須 |
Width | Integer | キャンバスの幅、単位: ピクセル | 450 | はい |
Height | Integer | キャンバスの高さ、単位: ピクセル | 800 | はい |
OutputTemplateConfig パラメーターの説明
パラメーター | タイプ | 説明 | 値の例 | 必須 |
Width | Integer | 出力幅、px | 1920 | はい |
Height | Integer | 出力高、px | 1080 | はい |
JSONObject | Crf、Codec などの出力ビデオストリーム構成。 | {"Crf": 27} | いいえ |
パラメーターの例
{
"Name": "batch-editing-template-1",
"Type": "BatchEditing",
"Config": {
"InputTemplateConfig": {
"BackgroundImageArray": [
"https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].png"
],
"BackgroundMusicArray": [
"icepublic-0c4475c3936f3a8743850f2da942ceee"
],
"StickerArray": [
{
"MediaURL": "https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].jpeg",
"X": 0.1,
"Y": 0.1,
"Width": 0.1,
"Height": 0.1
}
]
},
"EditingTemplateConfig": {
"TitleConfig": {
"Y": 0.7
},
"SpeechConfig": {
"Voice": "zhifei",
"AsrConfig": {
"Y": 0.9
}
}
},
"OutputTemplateConfig": {
"Width": 1080,
"Height": 1920
}
}
}