ナビゲーションにスキップ

ビデオto音楽

1つ以上のビデオファイルからバックグラウンド音楽を生成します。ビデオは順番に結合されます。任意の説明とスタイルタグが、生成される音楽に影響します。

ヘッダー

xi-api-keystringオプション

クエリパラメータ

output_formatenumオプション

生成されたオーディオの出力形式。codec_sample_rate_bitrate形式で指定します。たとえば、サンプルレート22.05kHz、32kbpsのmp3はmp3_22050_32で表します。ビットレート192kbpsのMP3を使用するには、クリエイター以上への加入が必要です。サンプルレート44.1kHzのPCM形式を使用するには、プロ以上への加入が必要です。μ-law形式(mu-lawとも表記され、u-lawと近似表記されることもあります)は、Twilioのオーディオ入力で一般的に使用されます。

enable_loggingbooleanオプションデフォルト値 true

enable_loggingがfalseに設定されている場合、このリクエストにはゼロ保持モードが使用されます。ゼロ保持モードを利用できるのはエンタープライズのお客様のみです。

リクエスト

This endpoint expects a multipart form with multiple files.
videosfiles必須

FormData配列(multipart/form-data)で送信される1つ以上のビデオファイルです。順番に1つのコーデックに結合されます。 ビデオは最大10本まで指定でき、結合後の合計サイズは200MBまでです。 ビデオの合計時間は最大600秒です。複数のビデオを結合すると、リクエスト時間が大幅に長くなる場合があります。可能であれば、事前にビデオを結合してください。

descriptionstring or nullオプション1-4100 characters

希望する音楽の任意のテキスト説明です。最大4,100文字まで指定できます。

tagslist of stringsオプションデフォルト値 []

任意のスタイルタグのリストです(例:[‘upbeat’, ‘cinematic’])。最大10個のタグを指定できます。

model_idenumオプションデフォルト値 music_v1

生成に使用するモデル。

許可された値:
add_sfxbooleanオプションデフォルト値 false

trueの場合、ビデオのSFXキューを取り入れます。

separate_tracksbooleanオプションデフォルト値 false

trueの場合、単一のミックス済みファイルではなく、音楽とSFXのオーディオトラックを分けたZIPを返します。トラックをより柔軟にレイヤー化する場合に使用します。

use_audio_as_referencebooleanオプションデフォルト値 false

trueの場合、ビデオのオーディオトラックを分析し、そのジャンル、BPM、使用楽器、ムード、展開を音楽生成の参照特性として使用します。

sign_with_c2pabooleanオプションデフォルト値 false

生成した楽曲にC2PA署名を付与するかどうか。mp3ファイルにのみ適用されます。

レスポンスヘッダー

song-idstringオプション

生成された曲の一意の識別子

レスポンス

ビデオに合わせて生成されたオーディオファイル。Content-Typeとファイル拡張子はoutput_formatパラメータ(デフォルトはmp3)によって異なります。

エラー

403
Forbidden Error
422
Unprocessable Entity Error