API de provenance du contenu (bêta)

Les contenus audio générés par ElevenLabs comportent un filigrane inaudible intégré directement aux échantillons audio. Le point de terminaison de provenance du contenu, POST /v1/content-provenance/watermark, lit un fichier que vous importez et vous indique s’il en détecte un.

Lorsque le filigrane correspond à un enregistrement de génération, la réponse indique le produit et le modèle ayant produit l’audio, la date de génération et un identifiant pour cette génération. Elle n’inclut jamais le prompt, le compte ou l’utilisateur à l’origine de la génération.

Informations fournies par le filigrane

Une vérification terminée renvoie deux champs : is_detected et details.

is_detected est défini sur true lorsque le décodeur reconnaît un filigrane ElevenLabs dans le fichier, et sur false dans le cas contraire.

details est renseigné uniquement lorsque les détails de la génération peuvent être récupérés à partir du filigrane, ce qui peut être impossible pour un audio court ou fortement modifié. Il contient alors product, model, generated_at et unique_id. Chacun de ces quatre champs peut être null. Si aucun enregistrement ne correspond ou qu’aucun filigrane n’est détecté, details est null.

Vous pouvez également envoyer version pour choisir le décodeur qui lit le fichier. Omettez-le, ou envoyez latest, pour utiliser le décodeur le plus récent. Actuellement, seul latest est pris en charge.

Vérifier un fichier

Importez l’audio sous forme de formulaire multipart avec le nom de champ file, puis définissez le type de média de la partie, par exemple audio/mpeg. Votre clé API doit disposer de l’autorisation de filigrane. Les jetons d’accès OAuth ne sont pas acceptés.

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 est facultatif. Pour l’envoyer explicitement :

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"

Un fichier contenant un filigrane renvoie une réponse de ce type :

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

Limites

Fichiers acceptés. Tout type audio/* que le décodeur peut lire, notamment MP3, WAV, FLAC, AAC et Ogg. Vous pouvez également omettre le type de média ou envoyer application/octet-stream. Une image ou tout autre type non audio renvoie 400 avec le statut invalid_file_type.

Taille et durée. Chaque fichier peut faire jusqu’à 50 Mo et durer entre 0,5 seconde et 5 minutes après décodage. Envoyez un fichier par requête.

Limite de débit. Chaque utilisateur de clé API peut soumettre 25 vérifications par période de 24 heures. Les requêtes dépassant cette limite renvoient 429. Si vous avez besoin d’une limite plus élevée, contactez-nous.

Gestion des erreurs

Il est préférable de réessayer plus tard après un 429. Un 400 ou un 422 signifie que la requête elle-même doit être modifiée, par exemple en raison d’un fichier non audio ou d’une valeur version autre que latest.

Utiliser le résultat

Le point de terminaison lit uniquement le filigrane déjà présent dans le fichier. La réponse ne contient ni prompt ni compte. Pour toute décision dépendant de l’origine d’un contenu audio, faites intervenir une personne.