Build on OGQ.
Stickers, music, IP — all via one API.

파트너 API 키 발급

OGQ 어드민이 파트너 온보딩(DID 발급 단계까지)과 키 발급을 함께 처리합니다. 평문 키는 발급 시 한 번만 보여집니다. 모든 요청에 X-OGQ-API-KEY 헤더로 보냅니다 — 파트너 신원은 저장된 키 행에서 읽으므로 요청으로는 바꿀 수 없습니다.

계약(제안) 확인 — 무엇을 가져갈 수 있는가

가져갈 범위·판매 형태·기간은 계약이 정합니다. 응답의 bundle 이 종류·장르· 테마·의도이고, 주문은 그 범위 밖으로 나갈 수 없습니다.

curl -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  "https://stg.nova.ogq.me/api/v1/offers"

카탈로그 조회 — 무엇이 담기고 무엇이 안 담기는가

kind 는 필수입니다. purpose 를 주면 그 목적에 동의하지 않은 콘텐츠는 아예 나오지 않고, 승인이 필요한 것은 eligible:false 로 옵니다. 목록이 limit 보다 짧아도 끝이 아닙니다 — 끝은 nextCursor 가 null 일 때뿐입니다.

curl -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  "https://stg.nova.ogq.me/api/v1/catalog?kind=image&genre=scenery&purpose=aiTraining&limit=50"

주문 — 카테고리를 골라 담는다

항목마다 반출 관문 6검사가 돕니다. 막힌 항목은 주문을 실패시키지 않고 excluded[] 에 사유를 달고 남습니다. 한 번에 200건이므로 remaining 이 남으면 /expand 로 이어받습니다. Idempotency-Key 는 주문마다 새로 만드세요.

curl -X POST \
  -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"offerId":"...","selection":{"kind":"image","genres":["scenery"]},
       "purpose":"aiTraining","destCountry":"US","acks":["us_export_control"]}' \
  "https://stg.nova.ogq.me/api/v1/orders"

인출 → 매니페스트 — 실제로 받아 간다

인출은 항목마다 관문을 한 번 더 돌립니다 — 주문 뒤 창작자가 동의를 거두었으면 그 항목은 여기서 멈추고 failed[] 에 사유가 실립니다. 매니페스트의 서명 URL 은 1시간짜리 소지자 토큰이니 재배포하지 마세요(만료되면 같은 페이지를 다시 부르면 새로 서명됩니다).

curl -X POST -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  "https://stg.nova.ogq.me/api/v1/orders/$ORDER_ID/release"

curl -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  "https://stg.nova.ogq.me/api/v1/orders/$ORDER_ID/manifest?limit=50&format=jsonl"

사용 신고 — 정산의 근거

묶음 정액 계약은 그 기간 요금을 신고량 비례로 항목에 나눕니다. 신고하지 않은 항목은 그 기간 몫이 0 이 되므로, 받아 간 항목은 빠짐없이 신고하세요.

curl -X POST \
  -H "X-OGQ-API-KEY: $OGQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"periodStart":"2026-10-01","periodEnd":"2026-10-31","usageType":"training",
       "items":[{"contentId":"...","usageCount":1200}]}' \
  "https://stg.nova.ogq.me/api/v1/orders/$ORDER_ID/usage"