OGQ

OGQ Developer Platform

OGQ Open API & MCP
AI 시대 첫 IP 마켓플레이스

OGQ의 5,900만 에셋과 AI 창작 엔진을 API 하나로 연동하세요. Claude · ChatGPT · Cursor가 직접 검색·구매·생성하는 MCP 서버도 제공합니다.

Lawful IP only · 분쟁 zeroOGQ Synth ID 발급·검증 APIRate limit 공개(시간당 1,000 req · Free)UCI 자동 발급
API 키 발급받기MCP 연결하기B2B 파트너 문의
Dataspace 호환DSP 2024-1 · ODRL 2.2 · DCP v1.0

이런 분들에게 유용합니다

IP 콘텐츠 플랫폼을 운영하시는 분AI 기반 창작 서비스를 만들고 계신 분굿즈/커머스 IP 연동이 필요한 분교육 콘텐츠에 스티커/음악을 넣고 싶은 분AI 에이전트에 IP 검색/구매 기능을 추가하고 싶은 분

시작하기

첫 호출까지, 5분.

API 키 하나로 요청부터 응답 확인까지 끝납니다.

Step 1 — 요청

Request
curl -X GET "https://api.ogq.me/v1/assets?category=sticker&limit=10" \
  -H "Authorization: Bearer ogq_pk_your_api_key" \
  -H "Content-Type: application/json"

Step 2 — 응답

Response
{
  "data": [
    {
      "id": "ast_abc123",
      "title": "귀여운 고양이 스티커 팩",
      "category": "sticker",
      "origin": "human",
      "synthid_verified": true,
      "price": { "amount": 1500, "currency": "KRW" },
      "creator": { "name": "Cat Lovers", "grade": "star" },
      "rights": { "secondary_creation": true, "commercial_use": true }
    }
  ],
  "meta": { "total": 59000000, "page": 1, "limit": 10 }
}

파트너 API

필요한 건 전부 API로 있습니다.

모든 API는 Authorization: Bearer API_KEY 헤더가 필요합니다. «준비 중» 표시된 엔드포인트는 아직 호출할 수 없습니다.

MethodEndpoint설명상태크레딧
GET/api/v1/ipIP 콘텐츠 목록 조회 (카테고리·페이지네이션)제공 중0
GET/api/v1/ip/:idIP 콘텐츠 상세 (권리, 가격, OGQ Synth ID)제공 중0
GET/api/v1/assets에셋 목록 조회 (필터, 페이지네이션)준비 중미정
GET/api/v1/assets/:id에셋 상세 정보 (권리, 가격, OGQ Synth ID)준비 중미정
POST/api/v1/assets/search키워드/카테고리 기반 에셋 검색준비 중미정
POST/api/v1/license/purchase라이선스 구매 (크레딧 차감)준비 중미정
GET/api/v1/creators/:id크리에이터 프로필 및 작품 목록준비 중미정
POST/api/v1/ai/generateAI 콘텐츠 생성 (스티커/음악/영상)준비 중미정
GET/api/v1/trending인기 에셋 실시간 순위준비 중미정
POST/api/v1/webhook/register웹훅 URL 등록 (HMAC-SHA256)준비 중미정
POST/api/v1/synthid/generateOGQ Synth ID 생성 — IP 소유권 등록제공 중10
POST/api/v1/synthid/verifyOGQ Synth ID 검증 — 소유권/진위 확인제공 중5
POST/api/v1/synthid/watermark워터마크 삽입 — 이미지/텍스트/오디오제공 중5
POST/api/v1/synthid/extract워터마크 추출 — 소유권 증거 추출제공 중3
POST/api/v1/synthid/batch대량 등록 (JSON) — 최대 1,000건/요청제공 중1 / 항목
POST/api/v1/synthid/batch-file대량 등록 (CSV·ZIP) — 최대 1,000행/파일제공 중1 / 항목
GET/api/v1/synthid/anchor-status등록 시점 앵커 상태 조회 — 배치·루트·변조 여부제공 중1
GET/api/v1/synthid/monitor도용 모니터링 조회 — 발견 원장·웹훅 배달 현황제공 중1
POST/api/v1/synthid/similar유사 콘텐츠 검색 — aHash 해밍 거리제공 중20
POST/api/v1/synthid/crawl요청 기반 도용 스캔 (1건)제공 중10
POST/api/v1/synthid/detect워터마크 탐지 — 콘텐츠에서 OGQ Synth ID 검출제공 중5
POST/api/v1/synthid/infringement-scan침해 스캔 — quick 10 / full 15제공 중10 ~ 15
GET/api/v1/synthid/usageOGQ Synth ID 사용량/과금 조회제공 중0
GET/api/v1/synthid/reportOGQ Synth ID 리포트 조회제공 중0
POST/api/v1/uci/issueUCI 발급 — 한국저작권위원회 식별자제공 중3
POST/api/v1/search/similar이미지 유사 검색 (Vision)제공 중5

로봇·피지컬 AI 데이터셋 업로드 API 는 파트너 키가 아니라 OGQ 로그인 세션을 씁니다 — OPD OpenAPI 스펙

Free 티어는 월 100 크레딧까지 무료로 쓸 수 있습니다. 사용량은 위 표 기준으로 차감되며, 남은 한도는 GET /api/v1/synthid/usage 에서 확인할 수 있습니다.

OGQ Synth ID · IP 보호

소유권 증명부터 도용 탐지까지.

콘텐츠 소유권을 증명하고 도용을 탐지합니다. 강건성은 변형별로 실측해 아래 표에 나온 그대로 공개합니다 — 재압축에는 강하고, 자르기·리사이즈 같은 기하 변형에는 약합니다.

OGQ Synth ID 검증 페이지

텍스트, 이미지, 음악, 동영상의 소유권을 즉시 검증하세요

검증하기

기술 검증

어떤 기술이 어디에 적용돼 있나

Perceptual Hash

자르기·뒤집기·리사이즈 같은 변형에 견디도록 설계된 지각 해시

Zero-Width Steganography

텍스트에 보이지 않는 워터마크 삽입

HMAC-SHA256

OGQ Synth ID 위조 방지 서명

적용 기술과 검증 현황

아래 「강건성 실측 결과」의 변환별 수치는 임베더를 실제로 돌려 얻은 값입니다. 측정하지 않은 기술은 「미측정」으로 표시합니다.

기술적용 위치상태강건성 실측
DCT 주파수 도메인 워터마크프로덕션 임베더 (이미지)적용 중40/140 생존
FFT Spread Spectrum프로덕션 임베더 (오디오)적용 중16/16 생존
제로폭 스테가노그래피워터마크 삽입/추출 API (텍스트)적용 중미측정
Perceptual Hash (aHash · pHash)유사 검색 · 도용 탐지적용 중미측정
HMAC-SHA256 서명OGQ Synth ID 식별자 위조 방지적용 중해당 없음
QIM + DWT + BCH내부 라이브러리 (프로덕션 경로 미연결)준비 중미측정

강건성 실측 결과

2026-09-07에 측정한 값입니다. 워터마크가 다시 검출된 경우만 생존으로 셉니다. 표본은 실제 마켓 자산이 아니라 합성 콘텐츠이고, 측정 스크립트는 services/synthid-gateway/tests/bench_robustness.py 입니다. 나온 값을 그대로 싣습니다.

이미지 — DCT 주파수 도메인 DCT_V1

표본 20개 · 삽입 화질 PSNR 49.17dB

변환생존
PNG re-encode대조군20/20 생존
JPEG Q9020/20 생존
JPEG Q7520/20 생존
JPEG Q500/20 생존
Resize x0.750/20 생존
Resize x0.500/20 생존
Crop 10% per edge0/20 생존
Crop 25% per edge0/20 생존

오디오 — FFT 확산 스펙트럼 FFT_SS_V1

표본 8개 · 삽입 화질 SNR 33.32dB

변환생존
WAV re-encode대조군8/8 생존
OGG/Vorbis re-encode8/8 생존
MP3 re-encode8/8 생존

영상 — 프레임 DCT KEYFRAME_DCT_V1

표본 4개 · 삽입 화질 PSNR (frame avg) 44.36dB

변환생존
MP4 read-back대조군4/4 생존
Transcode, same resolution4/4 생존
Transcode + resize x0.500/4 생존

요금

쓰는 만큼만, 투명하게

판매 없이 IP 등록·추적·도용 탐지만 이용하는 구독 플랜입니다.

Free

무료

API 사용량 월 100 크레딧

도용 모니터링 내부 원장 스캔(외부 검색 준비 중)

Pro

₩99,000/월

API 사용량 월 10,000 크레딧

도용 모니터링 내부 원장 스캔(외부 검색 준비 중)

MOST POPULAR

Business

₩490,000/월

API 사용량 월 100,000 크레딧

도용 모니터링 내부 원장 스캔(외부 검색 준비 중)

Enterprise

별도 계약

API 사용량 별도 협의

도용 모니터링 별도 협의

OGQ 마켓에서 판매하는 크리에이터는 OGQ Synth ID 무료 (판매 수수료에 포함)

유료 티어 구독 결제는 준비 중입니다. 개시 시점은 별도 공지합니다. 현재는 Free 티어 한도로 이용할 수 있습니다.

호출 1건당 차감 크레딧

티어 월 한도는 아래 차감액의 합계로 계산됩니다. 남은 한도는 GET /api/v1/synthid/subscribe 에서 확인할 수 있습니다.

API설명크레딧
OGQ Synth ID 생성IP 등록 + 식별자 발급 + DB 저장10
OGQ Synth ID 검증소유권/진위 확인 (HMAC + DB)5
워터마크 삽입이미지/텍스트/오디오 워터마크5
워터마크 추출소유권 증거 추출3
대량 등록 (배치)최대 1,000건/요청 — 항목당1
대량 등록 (파일)CSV·ZIP 업로드 — 항목당1
앵커 상태 조회등록 시점 배치·루트·변조 여부1
도용 모니터링 조회발견 원장·웹훅 배달 현황1
사용량 조회과금/대시보드무료

운영 도구

등록·이력·탐지에 쓰는 API

IP 등록·이력·탐지 도구

배치 등록 API

CSV·ZIP 파일 업로드로 한 요청에 최대 1,000건 등록합니다. ZIP 안의 이미지는 해시·크기·형식을 자동으로 읽습니다(PNG·JPEG·GIF·WebP). 그 밖의 매체 메타데이터 추출과 더 큰 규모의 비동기 등록은 준비 중입니다.

등록 시점 기록

등록·워터마크 이력을 서버 원장에 시각과 함께 남기고, 주기적으로 머클 해시 트리로 묶어 변조 검증용 배치를 만듭니다. 검증 API로 배치·루트·변조 여부를 조회할 수 있습니다. 온체인 앵커링은 준비 중입니다.

도용 탐지 API

등록한 콘텐츠를 주기적으로 스캔해 도용 의심 건을 발견 원장에 남기고, 등록한 웹훅으로 HMAC 서명과 함께 보냅니다. 같은 발견으로 알림이 두 번 가지 않습니다. 지금 확인되는 것은 같은 콘텐츠 해시가 다른 소유자로 등록된 경우이며, 외부 웹 검색 연동은 준비 중입니다.

파트너 대시보드

API 키 발급 후 GET /api/v1/synthid/usage 로 실시간 사용량/과금을 조회하고, 자체 대시보드를 구축할 수 있습니다.

curl -H "X-OGQ-API-KEY: your-key" https://nova.ogq.me/api/v1/synthid/usage

MCP 서버

AI가 직접 쓰는 마켓.

Claude Code, Gemini, Grok 등 AI 에이전트가 OGQ 에셋을 직접 검색·구매할 수 있는 MCP(Model Context Protocol) 서버입니다.

연결 가이드

MCP 연결 (.claude/settings.json)
{
  "mcpServers": {
    "ogq": {
      "url": "https://mcp.ogq.me/sse",
      "headers": {
        "Authorization": "Bearer ogq_pk_your_api_key"
      }
    }
  }
}

제공 도구

search_assets

에셋 검색 — 카테고리, 키워드, 가격 범위로 IP 에셋 검색

get_asset_detail

에셋 상세 — 권리 정보, OGQ Synth ID 인증, 가격, 다운로드 URL

purchase_license

라이선스 구매 — 크레딧으로 에셋 라이선스 즉시 구매

generate_sticker

AI 스티커 생성 — 텍스트 프롬프트로 스티커 이미지 생성

get_creator_profile

크리에이터 조회 — 프로필, 작품 목록, 등급 정보

개발 도구

당신의 언어로 시작하세요.

TypeScript와 Python SDK를 공식 지원합니다. CLI는 곧 출시됩니다.

Node.js / TypeScript

npm install @ogq/sdk

Python

pip install ogq-sdk

B2B 통합

계약부터 정산까지, 인프라로 제공합니다.

계약 단위 대량 라이선스부터 굿즈 자동 발행, 데이터스페이스 표준까지.

B2B IP 라이선스

캐릭터·브랜드·세계관 IP를 계약 단위로 일괄 라이선스합니다. 60% 자동 정산, PARTNER 등급 개별 계약.

8개 PoD 마켓 어댑터

국내외 8개 마켓에 굿즈를 자동 발행합니다. 자체 어댑터도 추가할 수 있습니다 (IAdapter 패턴).

데이터스페이스 EDC

Eclipse EDC 0.17 호환 + ODRL 정책 + DCAT 메타 + DCP 인증 + IdentityHub. NIA 한국형 참조모델 v1.0.

광고 보상 검증 자동화

AdMob SSV·Naver Ad Post 보상을 검증해 사용자 크레딧으로 자동 적립합니다 (ECDSA P-256, JWKS 캐시).

정산 자동화 (3만원~)

부가세·원천세·공급가액을 자동 분리하고, 세금계산서 PDF와 정산 내역서 XLSX를 자동 발행합니다.

8개 PoD 어댑터 상세

네이버 스마트스토어

네이버 스마트스토어

KR

Amazon

Amazon

GLOBAL

29

29CM

KR

T

T 스토어

KR

쿠팡 마켓플레이스

쿠팡 마켓플레이스

KR

Redbubble

Redbubble

GLOBAL

Teespring

Teespring

GLOBAL

B

BOOTH

JP

굿즈 등록 시 autoPublish 옵션을 켜면 8개 마켓에 동시 발행됩니다.

플랫폼 플러그인

쓰던 도구 안에서 끝납니다.

사용자가 OGQ 마켓에 오지 않아도 됩니다. 플러그인 안에서 검색부터 구매, 삽입까지 끝납니다.

Slack

Slack

베타

/ogq 명령으로 스티커·이모지 삽입

Canva

Canva

베타

Canva Apps SDK — 디자인에 IP 직접 사용

Figma

Figma

도입 단계

디자인 에셋 검색 + 1 클릭 삽입

Notion

Notion

도입 단계

임베드 블록으로 OGQ 콘텐츠 삽입

Telegram Mini App

Telegram Mini App

운영 중

BotFather 토큰만 등록하면 즉시 스티커 판매 (Stars 결제)

운영 중인 파트너

이미 함께하고 있습니다.

7개 채널이 OGQ API·위젯·MCP로 라이선스 IP를 운영하고 있습니다. 로고는 계약상 일부만 공개합니다.

NAVER
SOOP
BAND
채팅+
KT
LG U+
연합뉴스

신뢰성·보안

보안 걱정은 덜어두셔도 됩니다.

엔터프라이즈 도입에 필요한 검토 항목을 미리 준비해 두었습니다.

가용성 모니터링

24시간 모니터링과 에러 트래킹으로 장애를 추적합니다. 가용률(SLA) 수치는 아직 측정 전이며, 측정 체계가 서면 공개합니다.

환경 분리 (준비 중)

지금 발급되는 키는 Production 키 하나입니다. 호출은 티어 월 크레딧 한도에서 그대로 차감됩니다. 무과금 Sandbox 환경은 준비 중입니다.

무중단 마이그레이션

스키마 변경은 Flyway로 사전 적용하고 Blue/Green으로 배포해 중단이 없습니다.

API Key 보안

키는 SHA-256 해시로 저장됩니다. 티어별 Rate Limiting과 즉시 재발급·회수를 지원합니다.

Webhook 신뢰성

HMAC-SHA256 서명과 멱등 키, 자동 재시도와 DLQ로 유실 없이 전달합니다.

감사 로그

모든 API 호출 로그를 보존합니다. 파트너 대시보드에서 실시간으로 추적할 수 있습니다.

B2B 파트너 문의

대량 연동, 커스텀 API, 전용 MCP 서버가 필요하신가요? 파트너 팀이 함께 설계해 드립니다.

partner@ogq.meAPI 키 발급받기

쿠키 사용 안내

OGQ 마켓은 더 나은 서비스를 위해 쿠키를 사용합니다. 필수 쿠키는 항상 활성화되며, 선택 쿠키는 동의 시에만 사용됩니다. 개인정보처리방침 보기