Intelligent Media Services:SubmitAvatarVideoJob

• これは非同期 API です。ジョブを送信すると、API はジョブ ID を返し、バックグラウンド処理のためにジョブをキューに入れます。サービスは、コールバック通知を介して最終結果を配信します。GetSmartJobResult 操作を呼び出して、ジョブのステータスをクエリすることもできます。

• 入力は、テキストまたは MP3/WAV 形式の音声ファイルです。

• 出力は MP4 と WebM の両方のフォーマットをサポートしています。出力フォーマットが MP4 の場合、ジョブはグリーンバックのアバタービデオと、ポストプロダクション用の別のアルファマスクビデオを生成します。このオプションを推奨します。出力フォーマットが WebM の場合、ジョブは透明な alpha チャンネルを持つ単一のビデオを生成し、フロントエンド表示に適しています。WebM フォーマットでのレンダリングは、エンコーディングが複雑なため、より時間がかかります。

• 出力には、生成された音声の文レベルのタイムスタンプが含まれており、その後のビデオ編集に役立ちます。

InputConfig の例

音声ファイルの URL を入力として指定：

{
  "InputFile": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp3"
}

テキストを入力として指定：

{
  "Text": "The quick brown fox jumps over the lazy dog."
}

MediaId を入力として指定：

{
  "MediaId": "4aef0c80cc0071edbf92f6e7c44b6302"
}

EditingConfig の例

AvatarId: 必須。アバターの ID。公式アバターのリストについては、公式アバターをご参照ください。
Voice: 任意。テキスト読み上げ合成の音声。このパラメーターは、入力がテキストの場合にのみ有効です。利用可能な音声については、Intelligent Speech の音声をご参照ください。
CustomizedVoice: 音声クローニングで作成されたカスタム音声を指定します。Voice パラメーターの代わりに使用します。
LoopMotion: ビデオの最初のフレームと最後のフレームが同一であるかどうかを指定します。true に設定すると、アバターの動きと表情が目立つことなくシームレスにループします。有効値は true と false です。デフォルト値は false です。
SpeechRate: 話速。このパラメーターは、入力がテキストの場合にのみ有効です。有効値の範囲は -500～500 です。デフォルト値は 0 です。
PitchRate: ピッチ。このパラメーターは、入力がテキストの場合にのみ有効です。有効値の範囲は -500～500 です。デフォルト値は 0 です。
Volume: ボリューム。このパラメーターは、入力がテキストの場合にのみ有効です。有効値の範囲は 0～100 です。デフォルト値は 50 です。
BackgroundUrl: 任意。背景画像の URL。このパラメーターを指定しない場合、背景はデフォルトで黒になります。サポートされているフォーマットは JPG と PNG です。解像度は 1080p で、アバターの向き (縦向きまたは横向き) と一致している必要があります。

{
  "AvatarId": "xinxin-marketing_standing", 
  "BackgroundUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.jpg",
  "Voice" : "zhichu",
  "LoopMotion": true,
  "SpeechRate": 100,
  "PitchRate": 10, 
  "Volume": 10 
}

OutputConfig の例

{
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp4"
}

GetSmartJobResult 操作を呼び出して、ジョブのステータスと結果をクエリできます。次のコードは、完了したジョブの成功応答の例を示しています。

{
	"RequestId": "2014D1A8-4143-164F-94B4-32B8F39B706D",
	"JobId": "d9367da8c7184ec7a3f24de530ac5b9a",
	"State": "Finished",
	"SmartJobInfo": {
		"Title": "default_title_2023-03-28T13:37:47Z",
		"EditingConfig": "null",
		"JobType": "AvatarVideo",
		"CreateTime": "2023-03-28T13:37:47Z",
		"ModifiedTime": "2023-03-28T13:37:47Z",
		"UserId": 1833202230108227,
		"outputConfig": {
			"mediaUrl": "https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4"
		}
	},
	"JobResult": {
		"MediaId": "4aef0c80cc0071edbf92f6e7c44b6302",
		"AiResult": "{\"outputVideoUrl\":\"https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4\",\"subtitleClips\":\"[{\\\"from\\\":0.0,\\\"to\\\":2.13,\\\"content\\\":\\\"The quick brown fox jumps over the lazy dog.\\\"}]\"}"
	}
}

次のコードは、AiResult パラメーターのフォーマットを示しています。
outputVideoUrl: MP4 形式の出力ビデオファイルの URL。
subtitleClips: 字幕の文レベルのタイムスタンプ。

{
	"outputVideoUrl": "https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4",
	"subtitleClips": "[{\"from\":0.0,\"to\":2.13,\"content\":\"The quick brown fox jumps over the lazy dog.\"}]"
}