QR Coding Logo Librarian
생성되는 이미지(포스터/아트워크)에 기관·브랜드 로고를 정확히 삽입한다. 핵심 원칙은 QR과 동일하다: 로고를 이미지 모델이 그리게 하지 말고, 검증된 소스(로고 URL)에서 가져와 결정적으로 합성한다. 유료 플랜 전용 기능이다.
로고 소스
- 기관 로고 — getlogo.kr
- getlogo.kr은 한국 관공서·공공기관 로고 디렉터리다. 파일을 직접 호스팅하지 않고 공식 출처 링크만 중계한다.
- 기관명/분류(중앙·지자체·공공기관)/지역으로 검색 → 해당 기관 항목 → **공식 출처(기관 공식 사이트의 CI/BI 페이지)**로 이동해 공식 로고 파일 URL을 확보한다. 가능하면 PNG 또는 SVG.
- 상표·저작권은 각 권리자에게 있다. 허가된 용도로만 사용하고, 로고를 변형·재색·왜곡하지 않는다.
- 본인 로고 — 링크 첨부
- 사용자가 제공한 로고 이미지 URL(https 또는 data:image)을 그대로 사용한다.
로고 리스트 관리
- 수집한 로고를
{이름, url}형태의 리스트로 관리한다(예: "행정안전부 → https://…/logo.png"). - 재사용이 필요하면 로고를 워크스페이스 라이브러리에 영속화한다: 이미지를 받아 base64
data:image/...로 만들어upload_logo호출 →logoAssetId확보. (단upload_logo는 PNG/JPG/WebP ≤100KB만 허용, SVG 불가. SVG 로고는 배치 시 URL을 직접 쓰면 된다.) - 라이브러리 조회/삭제는
list_logos/delete_logo.
정확한 배치 (핵심)
먼저 사용자에게 위치·크기·사용 방법을 물어 프롬프트에 반영한 뒤, compose_qr_overlay에 logo를 함께 전달한다:
compose_qr_overlay(
id,
imageTool: "gpt-image" | "gemini" | "codex",
placement: "card" | "transparent" | "framed",
logo: { url, position, size, note }
)
position:top-left·top-right·bottom-left·bottom-right·top-center·bottom-center·center(기본 top-right)size:small(12%) ·18%) ·medium(large(~26%) — 이미지 너비 대비 (기본 small)note: 사용 지침(예: "가로형 로고 사용", "주위 여백 확보", "헤더에 배치")- 반환되는 지시문은 "그 위치에 로고 자리를 비우고, 모델이 그리지 말고, 생성 후 URL의 실제 로고를 결정적으로 합성(QR과 그 여백 침범 금지, 색·비율 변형 금지)"을 담는다.
유료 게이팅
- 로고 배치는 유료 플랜 전용이다. 무료 플랜이
logo를 넣으면 로고 가이드 없이 업그레이드 안내만 반환된다. - 시작 전
get_account_status로 플랜을 확인하고, 무료면 업그레이드를 안내한다.
검증
- QR과 로고를 모두 합성한 뒤
validate_qr_scanability로 스캔 가능성을 확인한다. - 지원 옵션이 헷갈리면
get_capabilities의imageOverlay(placement·logoPlacement)를 먼저 확인한다.