音楽をアップロード

後でインペインティングに使用する音楽ファイルをアップロードします。アップロード料金は楽曲生成と同じです。アップロードされたすべてのコンテンツは著作権侵害について検査されます。著作権で保護されたコンテンツが検出された場合でも、リクエスト費用の半額が請求されます。

ヘッダー

xi-api-keystringオプション

リクエスト

This endpoint expects a multipart form containing a file.
filefile必須

アップロードするオーディオファイル。

extract_composition_planboolean or enumオプションデフォルト値 false
アップロードした曲の構成プランを生成して返すかどうか。返す構成プランの形式を制御するには、モデルID(`music_v1`、`music_v2`、または`music_v2_5`)を渡します。`true`/`false`の指定は非推奨です。`true`の場合はデフォルトで`music_v1`のプラン形式になります。これを有効にするとレイテンシーが増加します。
with_timestampsbooleanオプションデフォルト値 false

アップロードした楽曲を文字起こしし、単語レベルのタイムスタンプを返すかどうか。Trueの場合、レスポンスにwords_timestampsが含まれますが、レイテンシーが増加します。

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

アップロードした楽曲の視覚的な波形を返すかどうか。

レスポンス

任意の構成プランを含む音楽ファイルを正常にアップロードしました。

song_idstring

アップロードされた曲の一意の識別子

composition_planobject or nullオプション

アップロードした曲から抽出された構成プラン。リクエスト本文でextract_composition_planが指定された場合にのみ存在します。

words_timestampslist of objects or nullオプション

アップロードした楽曲から文字起こしされた単語レベルのタイムスタンプ。リクエスト本文でwith_timestampsがTrueの場合にのみ含まれます。

waveform_visuallist of integers or nullオプション

アップロードされた楽曲のプレビュー表示用の低解像度波形です。オーディオ1秒あたり4つの値を保持し、値の範囲は-1000~1000です。ステレオは単一チャンネルにミックスダウンされます。リクエスト本文でwith_waveform_visualがTrueの場合にのみ含まれます。

エラー

422
Unprocessable Entity Error