コンテンツ来歴API（ベータ版）
オーディオファイルにElevenLabsのウォーターマークが含まれているかを確認し、その生成元について分かる情報を解説します。
ElevenLabsが生成したオーディオには、オーディオサンプル自体に聞き取れないウォーターマークが埋め込まれています。コンテンツ来歴エンドポイントPOST /v1/content-provenance/watermarkは、アップロードされたファイルを読み取り、ウォーターマークが検出されたかどうかを返します。
ウォーターマークが生成記録と一致すると、レスポンスにはオーディオを生成したプロダクトとモデル、生成日時、その生成のidが含まれます。生成に使用されたプロンプト、アカウント、ユーザーが含まれることはありません。
ウォーターマークから分かる情報
確認が完了すると、is_detectedとdetailsの2つのフィールドが返されます。
is_detected は、デコーダーがファイル内のElevenLabsウォーターマークを認識した場合はtrue、認識しなかった場合はfalseです。
details は、ウォーターマークから生成情報を復元できた場合にのみ値が設定されます。短いオーディオや大幅に変更されたオーディオでは、復元できないことがあります。値が設定された場合は、product、model、generated_at、unique_idが含まれます。この4つは、いずれもnullになる可能性があります。一致する記録がない場合やウォーターマークが見つからない場合、detailsはnullです。
versionを指定して、ファイルを読み取るデコーダーを選ぶこともできます。最新のデコーダーを使用するには、省略するかlatestを指定してください。現在サポートされているのはlatestのみです。
ファイルを確認する
フィールド名をfileとして、オーディオをマルチパートフォームでアップロードし、各パートのメディアタイプ（audio/mpegなど）を設定します。APIキーにはウォーターマーク権限が必要です。OAuthアクセストークンは使用できません。
versionは任意です。明示的に指定する場合：
ウォーターマークを含むファイルでは、次のようなレスポンスが返されます：
制限
対応ファイル。 MP3、WAV、FLAC、AAC、Oggなど、デコーダーが読み取れる任意のaudio/*タイプに対応しています。メディアタイプを省略するか、application/octet-streamを指定することもできます。画像やその他のオーディオ以外のタイプを送信すると、ステータスinvalid_file_typeとともに400が返されます。
サイズと長さ。 各ファイルの上限は50 MBで、デコード後の長さは0.5秒以上5分以内である必要があります。1回のリクエストにつき1ファイルを送信してください。
レート制限。 各APIキーユーザーは、24時間あたり25回まで確認できます。この制限を超えるリクエストには429が返されます。上限を引き上げる必要がある場合は、お問い合わせください。
エラーへの対処
429の場合は、時間を置いて再試行してください。400または422の場合は、リクエスト自体を変更する必要があります。たとえば、オーディオ以外のファイルを送信した場合や、versionにlatest以外を指定した場合に返されます。
結果の利用
このエンドポイントは、ファイルにすでに含まれているウォーターマークだけを読み取ります。レスポンスにはプロンプトやアカウントの情報は含まれません。そのため、オーディオの生成元に基づいて判断する場合は、必ず人間による確認を行ってください。