Endpoints
DeepStamp
콘텐츠에 구조 기반 워터마크를 삽입하고 재사용을 탐지
POST
DeepStamp는 콘텐츠가 다시 쓰이거나 번역된 뒤에도 그 출처가 당신임을 증명합니다. 삽입(embed) 단계에서 콘텐츠의 시간 지식 그래프(TKG)를 추출하고 그 구조를 씨앗으로 삼은 워터마크를 숨깁니다. 탐지(detect) 단계에서는 워터마크와 인과 구조를 함께 사용해 저장된 모든 fingerprint와 대조합니다.
DeepStamp는 제품명이고, API 경로는 아직
fingerprint입니다. 엔드포인트는 /api/v1/fingerprint/embed와 /api/v1/fingerprint/detect이며 응답에도 fingerprint_id가 사용됩니다. /api/v1/deepstamp/* 엔드포인트는 없습니다.엔드포인트
POST /api/v1/fingerprint/embed
요청 본문
content와 url 중 하나만 보냅니다.
string
fingerprint를 생성할 원문 텍스트. 최대 50,000자.
string
fingerprint를 생성할 원본 문서의 URL.
string
기본값:"news"
콘텐츠 종류.
news, report, legal, internal 중 하나. 탐지 시 사용할 기본 가중치도 이 값에 따라 결정됩니다.object
직접 관리하는 식별자입니다. fingerprint와 함께 저장되며 매칭 결과에 그대로 반환됩니다.
응답
string
TKG 기반 zero-width 워터마크가 삽입된 콘텐츠입니다. 원문 대신 이 버전을 배포하세요.
string
고유 fingerprint 식별자(
fp_*). 내부 기사 id와 함께 보관하세요.object
콘텐츠에서 추출된 구조입니다.
string
fingerprint가 삽입된 시각(ISO 8601).
POST /api/v1/fingerprint/detect
요청 본문
content, url, fingerprint_id 중 정확히 하나만 보냅니다. content와 url로 들어온 질의는 즉시 추출만 하고 저장하지 않습니다.
string
검사할 원문 텍스트. 보통 확인하려는 기사 본문입니다. 최대 50,000자.
string
검사할 문서의 URL.
string
이미 삽입해 둔 fingerprint id(
fp_*)를 다시 채점합니다. 저장된 스냅샷을 재사용하므로 재추출이 없고, 주기적인 모니터링에 가장 저렴한 방식입니다.number
기본값:"5"
반환할 매칭 개수. 범위: 1–50.
number
기본값:"0.3"
결과에 포함될 최소 종합 점수입니다. 공통 신호가 전혀 없는 후보는 이 값과 무관하게 항상 제외됩니다.
match_found는 두 조건을 모두 통과한 매칭이 하나 이상일 때만 true입니다.number
기본값:"1000"
최신순으로 훑을 저장된 fingerprint의 최대 개수. 범위: 1–5000.
object
사용자 지정 가중치.
entity, time, causal의 합이 1.0이어야 합니다. 생략하면 content_type별 기본값이 적용됩니다. news 0.5 / 0.2 / 0.3, legal 0.3 / 0.1 / 0.6, report 0.4 / 0.3 / 0.3, internal 0.5 / 0.2 / 0.3.object
대조할 fingerprint 범위를 좁힙니다.
응답
boolean
min_score를 통과한 후보가 하나 이상이면 true입니다.number
최상위 매칭의 종합 점수입니다. 매칭이 없으면
0.string
질의의 fingerprint id입니다.
content나 url 질의의 경우 즉시 추출 과정에서 발급된 값이며 저장되지 않습니다.array
종합 점수 내림차순으로 정렬된 상위 K개 후보입니다.
object
다음 단계
Embed & Detect 실습
코드 예제와 함께 단계별로 따라가는 가이드.
Best practices
점수 산출, 필터링, 감사 로그에 대한 실전 팁.

