콘텐츠 출처 API(베타) | ElevenLabs Documentation

ElevenLabs에서 생성한 오디오에는 오디오 샘플 자체에 삽입된 들리지 않는 워터마크가 포함됩니다. 콘텐츠 출처 엔드포인트 POST /v1/content-provenance/watermark는 업로드한 파일을 읽고 워터마크를 찾았는지 알려줍니다.

워터마크가 생성 기록과 일치하면 응답에는 오디오를 생성한 제품과 모델, 생성 시점, 해당 생성의 ID가 표시됩니다. 프롬프트, 계정 또는 생성을 수행한 사용자 정보는 절대 포함되지 않습니다.

워터마크가 보고하는 정보

검사가 완료되면 is_detected와 details라는 두 필드가 반환됩니다.

**is_detected**는 디코더가 파일에서 ElevenLabs 워터마크를 인식했을 때 true이고, 인식하지 못했을 때 false입니다.

**details**는 워터마크에서 생성 세부 정보를 복원할 수 있을 때만 채워집니다. 짧거나 크게 변경된 오디오의 경우 복원이 불가능할 수 있습니다. 이 필드에는 product, model, generated_at, unique_id가 포함됩니다. 이 네 항목은 모두 null일 수 있습니다. 일치하는 기록이 없거나 워터마크를 찾지 못한 경우 details는 null입니다.

파일을 읽을 디코더를 선택하려면 version도 전송할 수 있습니다. 최신 디코더를 사용하려면 이 값을 생략하거나 latest를 전송하세요. 현재는 latest만 지원됩니다.

파일 확인

오디오를 필드 이름 file의 멀티파트 폼으로 업로드하고, 파트의 미디어 유형(예: audio/mpeg)을 설정하세요. API 키에는 워터마크 권한이 필요합니다. OAuth 액세스 토큰은 허용되지 않습니다.

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은 선택 사항입니다. 명시적으로 전송하려면 다음과 같이 하세요.

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"

워터마크가 포함된 파일은 다음과 같은 응답을 반환합니다.

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

제한 사항

허용되는 파일. 디코더가 읽을 수 있는 모든 audio/* 유형을 지원하며, MP3, WAV, FLAC, AAC, Ogg 등이 포함됩니다. 미디어 유형을 생략하거나 application/octet-stream을 전송할 수도 있습니다. 이미지 또는 기타 오디오가 아닌 유형을 전송하면 상태 invalid_file_type과 함께 400이 반환됩니다.

크기 및 길이. 각 파일은 최대 50MB이며, 디코딩 후 길이가 0.5초에서 5분 사이여야 합니다. 요청당 파일은 하나만 전송하세요.

속도 제한. 각 API 키 사용자는 24시간당 25회의 검사를 제출할 수 있습니다. 이 제한을 초과한 요청에는 429가 반환됩니다. 더 높은 제한이 필요하면 문의하세요.

오류 처리

429는 나중에 다시 시도해 볼 수 있습니다. 400 또는 422는 요청 자체를 변경해야 한다는 의미입니다. 예를 들어 오디오가 아닌 파일을 전송했거나 latest 이외의 version을 지정한 경우입니다.

결과 사용

이 엔드포인트는 파일에 이미 포함된 워터마크만 읽으며, 그 외의 정보는 읽지 않습니다. 응답에는 프롬프트나 계정 정보가 없으므로, 오디오의 출처에 따라 결정을 내려야 할 때는 사람이 검토하도록 하세요.