omd:media — 브랜드 자산 세트, 가진 채널로
입력은 DESIGN.md(토큰·서사·금지)와 .omd/config.json(omd:setup이 저장한 채널·예산)이다. config가 없으면
먼저 omd:setup을 돌린다 — 채널을 추측하거나 "키를 발급받으라"고 말하지 않는다.
1. 프롬프트 팩 (채널 무관, 항상 만든다)
assets/generated/<set>/PROMPTS.md — 항목마다:
- 역할(히어로 / 섹션 n / 아이콘 / OG) · 비율 · 크기
- 비율은 기본값에서 고르지 말고 「그 이미지가 들어갈 자리」에서 가져온다. 레이아웃 슬롯의 실제 종횡비를 재고(렌더가 있으면 그 박스, 없으면 설계 폭÷높이), 브랜드 증거가 있으면 그 브랜드 이미지의 관행 비율과 맞춘다. 히어로 16:9·OG 1.91:1·아이콘 1:1은 자리를 못 잰 경우의 최후 기본값이지 출발점이 아니다.
- 근거: T3-3 레인 A 108칸에서 **생성 이미지의 비율이 브랜드 이미지 관행에서 10% 넘게 벗어난 칸이 60%**였고, 근거 추종 축의 기계 수치는 세 도구 모두 40 이하였다(omd 33.8 · hallmark 34.6 · uiuxpromax 35.9). 페이지 안에서 잘려 나가는 비율은 p90 0.37로 오히려 완만했다 — 문제는 배치가 아니라 생성 시점에 고른 비율이다.
- 프롬프트 원문: 컨셉 한 문장 + 피사체 + 구도 + 빛·질감 + 팔레트 hex 잠금(DESIGN.md 토큰 인용 경로) + 금지(얼굴·로고·텍스트·스톡 느낌)
- 스타일 참조:
assets/_reference/캡처가 있으면 경로(Recraft style_id 생성 입력) - 랜딩이면
storyboard.md의 섹션별 에셋 계획을 그대로 읽는다(중복 작성 금지).
2. 채널 실행 (config media.image 순서대로, 실패 시 다음)
2.0 세트는 배치로 — openai-batch (OPENAI_API_KEY 가 있을 때 기본)
12~40장 세트는 낱장 호출이 아니라 OpenAI Batch API 로 한 번에 넣는다(출력 토큰 50% 할인, 공식 확인).
도구: node test-v2/tools/image-batch.mjs run --spec <set.json> --out <dir> — plan 은 오프라인이라 키 없이도
JSONL 과 비용 구조를 미리 볼 수 있다. 스펙의 styleSuffix 는 모든 프롬프트 끝에 토씨 그대로 붙는다
(우리 채널에는 시드가 없어 세트 일관성은 이것과 참조 이미지뿐이다). 참조 이미지가 있는 슬롯은 /v1/images/edits
배치로 자동 분리된다(최대 16장). 결과는 images/<id>.png + results.json(sha256·usage) + ledger.json(비용).
size 는 슬롯 실측 비율에서 고른다 — 허용 목록·제약은 도구가 검증한다.
| 채널 | 호출 | 산출 |
|---|---|---|
grok-build | grok --prompt-file <p> -m grok-4.6 --always-approve --cwd <run> — 프롬프트는 "image_gen으로 생성해 <path>로 cp" 지시 | jpg/png |
codex-imagegen | codex exec "<prompt>… save to <path>" ($imagegen, ChatGPT 로그인) | png |
gemini-nanobanana | gemini -p + nanobanana 확장(/generate) | png |
xai-api | POST /v1/images/generations (grok-imagine-image-2.0) — env XAI_API_KEY | jpg |
recraft-api | style 생성(참조 1–10장 → style_id, 레퍼런스별 1회) → svg 생성 | svg |
| 없음 | 프롬프트 팩 + assets/generated/QUEUE.md(사람이 돌릴 목록) + 팔레트 추상 SVG 플레이스홀더 | — |
grok-build 호출은 이 형태다(도그푸딩 2026-09-02에서 실패한 자유 조립 대신):
bashcat > "$RUN/media-hero.prompt" <<'EOF' image_gen 도구로 아래 프롬프트의 이미지를 1장 만들고, 결과 파일을 현재 디렉터리 기준 `assets/generated/hero/hero.jpg`에 저장(다른 곳에 저장됐으면 `cp`로 옮긴다). 마지막 줄에 저장한 파일의 절대 경로를 출력해라. 프롬프트: <PROMPTS.md의 원문> EOF grok --prompt-file "$RUN/media-hero.prompt" -m grok-4.6 --always-approve --cwd "$RUN" --output-format json > "$RUN/media-hero.out.json" # 비용은 응답 JSON의 total_cost_usd, 세션은 sessionId — 원장에 그대로 적는다
아이콘 세트는 Recraft가 없으면 인라인 SVG로 직접 그린다(24px 그리드, 1.5px 스트로크, DESIGN.md 색) — 이모지·아이콘 폰트 금지. 얼굴 사진·로고 생성 금지(로고는 다운로드만). 스톡 CDN 금지.
3. 원장 (필수)
assets/generated/LEDGER.md 표: 파일 · 역할 · 채널 · 모델 · 프롬프트 sha256 · 비용(USD, 추정이면 표시) · 생성 시각 · 재시도 · 라이선스/출처.
budgetUsdPerSet(기본 $1)를 넘기면 멈추고 남은 항목을 QUEUE로 돌린다. 기존 ## Used Assets 표(omd-asset-fetch)와 같은 파일에 합친다.
4. 검증
- 가로세로비가 프롬프트 팩과 맞는지(
sips -g pixelWidth -g pixelHeight(macOS) /file/identify;sharp는 설치본에 없다) — 픽셀 크기는 채널이 정한다(grok image_gen은 1280×720 고정)이므로 원장에 채널 상한을 적을 뿐 재생성 사유가 아니다. 비율이 어긋나면 1회 재생성. - 팔레트 근접(상위 6빈 ΔE)은 레포에서만
test-v2/tools/verify.mjs로 잰다 — 설치본에는 대응 명령이 없으므로 육안 검수 + 원장 기록으로 갈음. - 브랜드 이미지 성격 대조(브랜드 증거가 있을 때).
verify.mjs가 쓰는 허용 오차를 그대로 목표로 삼는다: 비율 상대오차 ≤ 0.10 · 평균 휘도 차 ≤ 0.20 · 다이내믹 레인지 차 ≤ 0.20 (둘 다 0–1 척도) · 팔레트 거리 ≤ 25. 벗어나면 프롬프트의 빛·대비·팔레트 문구를 고쳐 한 번 다시 생성하고, 두 번째도 벗어나면 그 사실을 원장에 적는다 — 통과한 척하지 않는다. 브랜드 증거가 없으면 이 항목은 「측정 불가」로 원장에 남긴다(생략이 아니라 기록). - 랜딩이면
node test-v2/tools/landing-integrity.mjs(설치본:omd check landing) LI-18~20(비디오 속성·스톡 호스트)이 통과해야 한다.
하드 룰
발급·결제 지시 금지 · 키 값 기록 금지 · DESIGN.md에 없는 색을 프롬프트에 넣지 않는다 · 생성물은 항상 "unofficial generated"로 표시할 수 있게 원장에 남긴다.
