> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# コンテンツ来歴API（ベータ版）

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アクセストークンは使用できません。

```bash
curl -X POST https://api.elevenlabs.io/v1/content-provenance/watermark \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F "file=@./example.mp3;type=audio/mpeg"
```

`version`は任意です。明示的に指定する場合：

```bash
curl -X POST https://api.elevenlabs.io/v1/content-provenance/watermark \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F "file=@./example.mp3;type=audio/mpeg" \
  -F "version=latest"
```

ウォーターマークを含むファイルでは、次のようなレスポンスが返されます：

```json
{
  "is_detected": true,
  "details": {
    "product": "Music",
    "model": "Eleven Music v2",
    "generated_at": "2026-07-27T18:34:12+00:00",
    "unique_id": "row-123"
  }
}
```

## 制限

**対応ファイル。** MP3、WAV、FLAC、AAC、Oggなど、デコーダーが読み取れる任意の`audio/*`タイプに対応しています。メディアタイプを省略するか、`application/octet-stream`を指定することもできます。画像やその他のオーディオ以外のタイプを送信すると、ステータス`invalid_file_type`とともに`400`が返されます。

**サイズと長さ。** 各ファイルの上限は50 MBで、デコード後の長さは0.5秒以上5分以内である必要があります。1回のリクエストにつき1ファイルを送信してください。

**レート制限。** 各APIキーユーザーは、24時間あたり25回まで確認できます。この制限を超えるリクエストには`429`が返されます。上限を引き上げる必要がある場合は、[お問い合わせください](https://elevenlabs.io/docs/help-center/other/how-can-i-contact-support)。

## エラーへの対処

`429`の場合は、時間を置いて再試行してください。`400`または`422`の場合は、リクエスト自体を変更する必要があります。たとえば、オーディオ以外のファイルを送信した場合や、`version`に`latest`以外を指定した場合に返されます。

## 結果の利用

このエンドポイントは、ファイルにすでに含まれているウォーターマークだけを読み取ります。レスポンスにはプロンプトやアカウントの情報は含まれません。そのため、オーディオの生成元に基づいて判断する場合は、必ず人間による確認を行ってください。