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.

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:

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:

{
  "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.

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.