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

# Content-Provenance-API (Beta)

Von ElevenLabs generiertes Audio enthält ein unhörbares Wasserzeichen, das direkt in die Audiosamples eingebettet ist. Der Content-Provenance-Endpunkt `POST /v1/content-provenance/watermark` liest eine von Ihnen hochgeladene Datei und teilt Ihnen mit, ob er eines findet.

Wenn das Wasserzeichen mit einem Generierungsdatensatz übereinstimmt, nennt die Antwort das Produkt und Modell, mit dem das Audio erstellt wurde, den Erstellungszeitpunkt sowie eine ID für diese Generierung. Sie enthält niemals den Prompt, das Konto oder den Nutzer hinter der Generierung.

## Was das Wasserzeichen meldet

Eine abgeschlossene Prüfung gibt zwei Felder zurück: `is_detected` und `details`.

**`is_detected`** ist `true`, wenn der Decoder ein ElevenLabs-Wasserzeichen in der Datei erkannt hat, und `false`, wenn nicht.

**`details`** wird nur ausgefüllt, wenn die Generierungsdetails aus dem Wasserzeichen wiederhergestellt werden können. Bei kurzem oder stark verändertem Audio ist dies möglicherweise nicht möglich. Das Feld enthält dann `product`, `model`, `generated_at` und `unique_id`. Jedes dieser vier Felder kann `null` sein. Wenn kein Datensatz übereinstimmt oder kein Wasserzeichen gefunden wurde, ist `details` gleich `null`.

Sie können auch `version` senden, um auszuwählen, welcher Decoder die Datei liest. Lassen Sie das Feld weg oder senden Sie `latest`, um den neuesten Decoder zu verwenden. Derzeit wird nur `latest` unterstützt.

## Datei prüfen

Laden Sie das Audio als Multipart-Formular mit dem Feldnamen `file` hoch und legen Sie den Medientyp des Teils fest, zum Beispiel `audio/mpeg`. Ihr API-Schlüssel benötigt die Berechtigung für Wasserzeichen. OAuth-Zugriffstokens werden nicht akzeptiert.

```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` ist optional. So senden Sie es explizit:

```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"
```

Eine Datei mit Wasserzeichen gibt etwa Folgendes zurück:

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

## Limits

**Akzeptierte Dateien.** Jeder `audio/*`-Typ, den der Decoder lesen kann, einschließlich MP3, WAV, FLAC, AAC und Ogg. Sie können den Medientyp auch weglassen oder `application/octet-stream` senden. Ein Bild oder ein anderer Nicht-Audio-Typ gibt `400` mit dem Status `invalid_file_type` zurück.

**Größe und Länge.** Jede Datei darf höchstens 50 MB groß und nach der Decodierung zwischen 0,5 Sekunden und 5 Minuten lang sein. Senden Sie eine Datei pro Anfrage.

**Rate Limit.** Jeder API-Schlüssel-Nutzer kann innerhalb von 24 Stunden 25 Prüfungen senden. Anfragen über diesem Limit geben `429` zurück. Wenn Sie ein höheres Limit benötigen, [kontaktieren Sie uns](https://elevenlabs.io/docs/help-center/other/how-can-i-contact-support).

## Fehlerbehandlung

Bei `429` sollten Sie es später erneut versuchen. Ein `400` oder `422` bedeutet, dass die Anfrage selbst geändert werden muss, zum Beispiel bei einer Nicht-Audio-Datei oder einer anderen `version` als `latest`.

## Ergebnis verwenden

Der Endpunkt liest ausschließlich das Wasserzeichen, das bereits in der Datei enthalten ist. Die Antwort enthält keinen Prompt und kein Konto. Beziehen Sie daher bei jeder Entscheidung, die von der Herkunft von Audio abhängt, eine Person ein.