APoT

워터마킹 가이드

이 가이드에서는 APoT API를 사용하여 디지털 콘텐츠에 워터마크를 적용하는 전체 프로세스를 단계별로 설명합니다. 워터마킹은 디지털 콘텐츠의 출처를 증명하고 무단 사용을 감지하는 데 중요한 역할을 합니다.

워터마킹이란?

워터마킹은 디지털 콘텐츠에 식별 정보를 삽입하는 기술입니다. APoT는 두 가지 주요 워터마킹 기술을 지원합니다:

  1. Saforus 워터마크: 특수 알고리즘을 사용하여 이미지에 보이지 않는 워터마크를 삽입합니다. 이 워터마크는 이미지 품질에 영향을 미치지 않으며 다양한 변환(크기 조정, 압축 등)에도 강인합니다.

  2. C2PA 메타데이터: Content Authenticity Initiative(CAI)의 표준을 구현한 C2PA(Coalition for Content Provenance and Authenticity)는 파일의 출처와 편집 이력을 추적할 수 있는 메타데이터를 추가합니다.

워터마킹 단계

1. API 키 발급받기

APoT API를 사용하려면 먼저 API 키가 필요합니다. API 키를 발급받으려면 admin@apot.io로 이메일을 보내주세요. 이메일에는 회사명, 사용 목적, 연락처 정보를 포함해 주세요. 영업일 기준 2일 이내에 API 키 발급 관련 정보와 함께 회신드립니다. 자세한 내용은 인증 페이지를 참조하세요.

2. 파일 업로드 링크 생성하기

첫 번째 단계는 파일 업로드 링크를 생성하는 것입니다. 이를 위해 파일 업로드 링크 생성 API를 호출하세요:

curl -X POST https://api.apot.io/claim/file-upload-link \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "image/jpeg",
    "fileName": "example.jpg"
  }'

응답:

{
  "fileId": "2ca0b132-cf83-4158-9353-121ff62a351e",
  "uploadLink": "https://storage.apot.io/upload/2ca0b132-cf83-4158-9353-121ff62a351e?signature=..."
}

3. 파일 업로드하기

생성된 업로드 링크를 사용하여 파일을 업로드하세요:

curl -X PUT "https://storage.apot.io/upload/2ca0b132-cf83-4158-9353-121ff62a351e?signature=..." \
  -H "Content-Type: image/jpeg" \
  --data-binary "@example.jpg"

4. 워터마킹 요청하기

파일 업로드가 완료되면 워터마킹 API를 호출하여 워터마크 작업을 시작하세요:

curl -X POST https://api.apot.io/watermark \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "2ca0b132-cf83-4158-9353-121ff62a351e",
    "options": {
      "watermarkType": ["saforus", "c2pa"],
      "data": {
        "author": "홍길동",
        "creationDate": "2023-03-15",
        "description": "예시 이미지입니다."
      },
      "mintNft": true,
      "storeIpfs": true
    }
  }'

응답:

{
  "status": "pending",
  "requestId": "f2be4d80-5c4f-42a5-a70b-8e7251cfa8e2",
  "fileId": "2ca0b132-cf83-4158-9353-121ff62a351e"
}

5. 워터마킹 상태 확인하기

워터마킹 작업은 비동기적으로 처리됩니다. 워터마킹 상태 확인 API를 사용하여 작업 상태를 확인하세요:

curl -G https://api.apot.io/watermark/f2be4d80-5c4f-42a5-a70b-8e7251cfa8e2 \
  -H "Authorization: Bearer {token}"

응답 (성공):

{
  "status": "success",
  "requestId": "f2be4d80-5c4f-42a5-a70b-8e7251cfa8e2",
  "fileId": "2ca0b132-cf83-4158-9353-121ff62a351e",
  "watermarkedUrl": "https://storage.apot.io/download/2ca0b132-cf83-4158-9353-121ff62a351e?signature=...",
  "expiredAt": 1679645467
}

6. 워터마크가 적용된 파일 다운로드하기

워터마킹 작업이 성공하면 응답에 포함된 URL을 통해 워터마크가 적용된 파일을 다운로드할 수 있습니다:

curl -o watermarked_example.jpg "https://storage.apot.io/download/2ca0b132-cf83-4158-9353-121ff62a351e?signature=..."

워터마킹 옵션

워터마킹 API는 다양한 옵션을 제공합니다:

워터마크 유형 (watermarkType)

워터마크 유형을 지정하여 원하는 워터마킹 기술을 선택할 수 있습니다:

  • "saforus": Saforus 워터마크를 적용합니다.
  • "c2pa": C2PA 메타데이터를 추가합니다.

두 가지 유형을 모두 사용하는 것이 권장됩니다. 이렇게 하면 두 가지 독립적인 워터마킹 기술을 통해 더 강력한 증명이 가능합니다.

메타데이터 (data)

워터마크에 포함할 커스텀 메타데이터를 지정할 수 있습니다. 예를 들어:

"data": {
  "author": "홍길동",
  "creationDate": "2023-03-15",
  "description": "예시 이미지입니다.",
  "copyright": "© 2023 APoT",
  "licenseType": "All Rights Reserved"
}

NFT 민팅 (mintNft)

mintNft 옵션을 true로 설정하면 워터마크가 적용된 콘텐츠의 메타데이터를 블록체인에 기록하여 NFT를 민팅합니다. 이를 통해 OpenSea와 같은 NFT 마켓플레이스에서 콘텐츠를 거래할 수 있습니다.

IPFS 저장 (storeIpfs)

storeIpfs 옵션을 true로 설정하면 콘텐츠의 메타데이터를 분산형 파일 시스템인 IPFS에 저장합니다. 이는 파일의 무결성과 가용성을 보장합니다.

워터마킹 모범 사례

메타데이터 선택

워터마크에 포함할 메타데이터를 신중하게 선택하세요. 저작권 정보, 생성 날짜, 저자 정보 등 콘텐츠의 출처를 명확히 할 수 있는 정보를 포함하는 것이 좋습니다.

워터마크 유형 조합

최상의 보호를 위해 Saforus 워터마크와 C2PA 메타데이터를 모두 사용하세요. 두 가지 독립적인 워터마킹 기술을 통해 더 강력한 증명이 가능합니다.

정기적인 검증

워터마크가 적용된 콘텐츠를 정기적으로 검증하여 워터마크가 제대로 적용되었는지 확인하세요. 검증 API를 사용하여 워터마크를 검증할 수 있습니다.

다음 단계

워터마크가 적용된 콘텐츠가 있다면 검증 API를 사용하여 워터마크를 검증하고 NFT 및 IPFS API를 통해 NFT 및 IPFS 관련 정보를 관리할 수 있습니다.

Was this page helpful?