adyou 0.3.0 → 0.5.0

package/dist/core/creatives/factory.js

@@ -0,0 +1,183 @@
+// 소재 공장 v2 — 컨셉 × 포맷(콘티) 영상을 끝까지 만든다.
+//   콘티(storyboard.ts · 훅→증명→행동 · 채점) → 클립 생성(Veo/Seedance · UGC 는 인물 발화 · 시네마틱은 4+4 컷 · ui_demo 는 실제 사이트 화면 스크롤) → 이어붙이기
+//   → 언어별 자막(상단 훅 + 하단 자막 + CTA · 안전영역) → 언어별 엔드카드 → 4:5·1:1 파생(파생 뒤 자막을 다시 얹어 위치가 어긋나지 않게).
+//   CLI(ops.ts)와 웹(pipeline.ts)이 같은 함수를 부른다. 원가는 onAsset 으로 건별 통보(청구는 호출자 · ×1.1).
+import fs from 'node:fs';
+import path from 'node:path';
+import { DERIVED_RATIOS, VIDEO_DIMS } from './media.js';
+import { genreStyle, TONE_WORDS } from './playbook.js';
+import { ctaLabel, renderConcept, renderOverlay, renderPhoneStage } from './render.js';
+import { langName, localizedBoard, localizedConcept, planStoryboards, translateCopy } from './storyboard.js';
+import { generateVideo } from './video.js';
+import { appendEndCard, burnCaptions, concatClips, deriveRatio, hasFfmpeg, kenBurnsClip, probe, uiDemoClip } from './videofx.js';
+/** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(언어별 문구) */
+export async function renderEndCard(dir, brief, concept, ratio, lang, backgrounds = {}) {
+    try {
+        const { w, h } = VIDEO_DIMS[ratio];
+        const sub = path.join(dir, `end_${lang}`);
+        fs.mkdirSync(sub, { recursive: true });
+        // 엔드카드 배경 = 그 비율의 생성 배경(브랜드 그래디언트만 남지 않게)
+        const out = await renderConcept(sub, { ...brief, language: lang }, concept, backgrounds, { force: false, only: [{ w, h, ratio, medium: 'meta', kind: 'poster' }] });
+        return out[0]?.file || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 자막 오버레이 묶음 — 훅(0~2.4초 · 상단) → 자막 줄(균등) → CTA(마지막 구간) */
+async function overlaysFor(dir, key, dims, text, cta, primary, durationSec, lang) {
+    const out = [];
+    const hookEnd = Math.min(2.4, durationSec * 0.3);
+    if (text.hook)
+        out.push({ png: await renderOverlay(path.join(dir, `${key}_${lang}_${dims.w}x${dims.h}_hook.png`), dims.w, dims.h, text.hook, { kind: 'hook', primary, lang }), start: 0, end: hookEnd });
+    const lines = text.captions.filter(Boolean).slice(0, 3);
+    if (lines.length) {
+        const from = text.hook ? hookEnd - 0.2 : 0;
+        const seg = (durationSec - from) / lines.length;
+        lines.forEach((t, i) => { void t; });
+        for (const [i, t] of lines.entries())
+            out.push({ png: await renderOverlay(path.join(dir, `${key}_${lang}_${dims.w}x${dims.h}_cap${i}.png`), dims.w, dims.h, t, { kind: 'line', primary, lang }), start: from + i * seg, end: from + (i + 1) * seg - (i === lines.length - 1 ? 0 : 0.1) });
+    }
+    out.push({ png: await renderOverlay(path.join(dir, `${key}_${lang}_${dims.w}x${dims.h}_cta.png`), dims.w, dims.h, cta, { kind: 'cta', primary, lang }), start: Math.max(0, durationSec - Math.min(3, durationSec / 3)), end: durationSec + 1 });
+    return out;
+}
+/** 컨셉의 영상 소재 전부(포맷 × 언어 × 비율) — 실패한 포맷은 건너뛰고 로그 · 성공한 건마다 onAsset */
+export async function produceConceptVideos(o) {
+    const log = o.log || (() => { });
+    const c = o.concept;
+    const out = [];
+    const ff = await hasFfmpeg();
+    if (!ff)
+        log('  ⚠ ffmpeg 가 없어 자막·엔드카드·비율 파생 없이 원본 영상만 써요');
+    const tone = o.tone || 'lively';
+    const tw = TONE_WORDS[tone];
+    const baseLang = o.brief.language || 'ko';
+    // 시장 언어만 만든다(브리프 언어가 시장에 없으면 번역 원문으로만 쓰고 그 언어 영상은 만들지 않음)
+    const langs = o.langs?.length ? [...new Set(o.langs)] : [baseLang];
+    const hasScreens = !!o.siteShot || !!(o.siteImages && o.siteImages.length);
+    const formats = [...new Set(o.jobs.map((j) => j.format || 'cinematic'))];
+    // 1) 콘티 — 컨셉에 없거나 포맷이 바뀌었으면 새로 쓰고 컨셉에 붙인다(호출자가 저장)
+    if (!c.storyboards?.length || formats.some((f) => !c.storyboards.some((b) => b.format === f))) {
+        log(`「${c.name}」 콘티 쓰는 중… (포맷 ${formats.join('·')} · 톤 ${tone})`);
+        c.storyboards = await planStoryboards(o.brief, c, { formats, durationSec: o.jobs[0]?.durationSec || 8, tone, goal: o.goal || 'traffic', hasScreens, log });
+    }
+    // 2) 시장 언어 번역(문구·자막·훅·대사)
+    const extra = langs.filter((l) => l.split('-')[0] !== baseLang.split('-')[0]);
+    if (extra.length && (!c.i18n || extra.some((l) => !c.i18n[l]))) {
+        log(`  ${extra.map(langName).join('·')} 로 문구·자막 옮기는 중…`);
+        c.i18n = { ...(c.i18n || {}), ...(await translateCopy(o.brief, c, c.storyboards, extra)) };
+    }
+    for (const job of o.jobs) {
+        const format = (job.format || 'cinematic');
+        const board = c.storyboards.find((b) => b.format === format) || c.storyboards[0];
+        const dims = VIDEO_DIMS[job.ratio];
+        const key = `${c.key}_${format}`;
+        const rawFile = path.join(o.dir, `${key}_${job.ratio}.raw.mp4`);
+        let costKrw = 0;
+        if (!fs.existsSync(rawFile)) {
+            log(`「${c.name}」 ${format} 영상 ${job.ratio.replace('x', ':')} ${job.durationSec}초 — 훅 「${board.hook}」 (${job.provider === 'veo' ? 'Veo 3.1' : 'Seedance 2.5'} · 장르 ${board.genre})`);
+            const clipFiles = [];
+            let failed = false;
+            for (const [ci, clip] of board.clips.entries()) {
+                const cf = path.join(o.dir, `${key}_${job.ratio}_c${ci}.mp4`);
+                try {
+                    if (clip.kind === 'ui_demo') {
+                        if (!ff)
+                            throw new Error('ffmpeg 없음');
+                        const stage = await renderPhoneStage(o.dir, dims.w, dims.h, o.brief.palette.primary, o.brief.palette.dark);
+                        if (o.siteShot)
+                            await uiDemoClip(o.siteShot, cf, { sec: clip.sec, stage, dims });
+                        else if (o.siteImages?.[0])
+                            await kenBurnsClip(o.siteImages[0], cf, { sec: clip.sec, dims });
+                        else
+                            throw new Error('사이트 화면이 없어요');
+                        log(`  화면 데모 컷 ${clip.sec}초 ✓ (생성 비용 0)`);
+                    }
+                    else {
+                        const person = format === 'ugc_selfie';
+                        const speech = clip.speech ? ` The person speaks to camera in ${langName(board.lang)}: "${clip.speech}". Natural lip sync, conversational, genuine.` : '';
+                        const prompt = `${clip.prompt}${speech} Style: ${genreStyle(board.genre)}. Camera: ${tw.camera}. Audio: ${job.audio ? `${board.music || tw.music}${person ? ', clear voice over the music' : ''}` : 'silent'}. No on-screen text, no subtitles, no captions, no logos, no watermark.`;
+                        const firstFrame = !person && ci === 0 ? (o.backgrounds[job.ratio] || undefined) : undefined;
+                        const r = await generateVideo({ file: cf, prompt, ratio: job.ratio, durationSec: clip.sec, model: job.model, resolution: job.resolution, audio: job.audio, firstFrame, refs: !firstFrame && !person ? o.refs?.slice(0, 3) : undefined, negative: 'text, subtitles, captions, letters, watermark, logo, blurry, distorted face, extra fingers', log });
+                        costKrw += r.costKrw;
+                        log(`  컷 ${ci + 1}/${board.clips.length} ${clip.sec}초 ✓ 원가 ₩${Math.round(r.costKrw).toLocaleString()}`);
+                    }
+                    clipFiles.push(cf);
+                }
+                catch (e) {
+                    const ck = Number(e.costKrw || 0);
+                    costKrw += ck;
+                    log(`  ❌ ${format} 컷 ${ci + 1} 실패 — ${e instanceof Error ? e.message.slice(0, 200) : e}${ck ? ` (원가 ₩${ck} 발생)` : ''}`);
+                    if (clip.kind === 'ui_demo' && clipFiles.length)
+                        continue; // 화면 컷만 빠지면 생성 컷으로 진행
+                    failed = true;
+                    break;
+                }
+            }
+            if (failed || !clipFiles.length) {
+                if (costKrw > 0)
+                    await o.onAsset?.({ concept: c.key, w: 0, h: 0, ratio: job.ratio, file: '', medium: 'meta', type: 'video', durationSec: 0, mime: 'video/mp4', costKrw, origin: 'ai', format });
+                continue;
+            }
+            try {
+                if (ff)
+                    await concatClips(clipFiles, rawFile, dims);
+                else
+                    fs.copyFileSync(clipFiles[0], rawFile);
+            }
+            catch (e) {
+                log(`  ⚠ 이어붙이기 실패(첫 컷만 사용): ${e instanceof Error ? e.message.slice(0, 120) : e}`);
+                fs.copyFileSync(clipFiles[0], rawFile);
+            }
+        }
+        // 3) 언어 × 비율 마감 — 원본(raw)에서 비율을 먼저 만들고 그 위에 자막·엔드카드
+        const ratios = [job.ratio, ...(ff ? DERIVED_RATIOS[job.ratio].filter((r) => !o.jobs.some((j) => j.ratio === r)) : [])];
+        for (const lang of langs) {
+            const lb = localizedBoard(board, c.i18n, lang);
+            const lc = localizedConcept(c, c.i18n, lang);
+            const cta = ctaLabel(c.cta, lang);
+            for (const ratio of ratios) {
+                const d = VIDEO_DIMS[ratio];
+                const finalFile = path.join(o.dir, `${key}_${lang}_${ratio}.mp4`);
+                let cur = rawFile;
+                let durationSec = job.durationSec;
+                if (ff) {
+                    try {
+                        const pr0 = await probe(rawFile);
+                        durationSec = pr0.durationSec;
+                        if (ratio !== job.ratio) {
+                            const df = path.join(o.dir, `${key}_${ratio}.raw.mp4`);
+                            if (!fs.existsSync(df))
+                                await deriveRatio(rawFile, df, ratio);
+                            cur = df;
+                        }
+                        if (job.captions) {
+                            const withCap = path.join(o.dir, `${key}_${lang}_${ratio}.cap.mp4`);
+                            await burnCaptions(cur, withCap, { overlays: await overlaysFor(o.dir, key, d, lb, cta, o.brief.palette.primary, durationSec, lang) });
+                            cur = withCap;
+                        }
+                        if (job.endCard) {
+                            const card = await renderEndCard(o.dir, o.brief, lc, ratio, lang, o.backgrounds);
+                            if (card) {
+                                const withEnd = path.join(o.dir, `${key}_${lang}_${ratio}.end.mp4`);
+                                await appendEndCard(cur, card, withEnd, 2);
+                                cur = withEnd;
+                                durationSec += 2;
+                            }
+                        }
+                    }
+                    catch (e) {
+                        log(`  ⚠ ${lang} ${ratio} 마감 실패(원본 사용): ${e instanceof Error ? e.message.slice(0, 160) : e}`);
+                    }
+                }
+                fs.copyFileSync(cur, finalFile);
+                const primary = lang === langs[0] && ratio === job.ratio;
+                const asset = { concept: c.key, w: d.w, h: d.h, ratio, file: finalFile, medium: 'meta', type: 'video', durationSec: Math.round(durationSec), mime: 'video/mp4', costKrw: primary ? costKrw : 0, origin: 'ai', format, lang, variant: `${format}_${lang}` };
+                out.push(asset);
+                await o.onAsset?.(asset);
+            }
+        }
+        log(`  ${format} 완성 — 언어 ${langs.join('·')} × 비율 ${ratios.map((r) => r.replace('x', ':')).join('·')}${costKrw ? ` · 생성 원가 ₩${Math.round(costKrw).toLocaleString()}` : ''}`);
+    }
+    return out;
+}

package/dist/core/creatives/images.d.ts

@@ -1,9 +1,38 @@
+export type ImageProvider = 'bizrouter' | 'openai';
 export declare function imageConfig(): {
     key: string;
     model: string;
+    base: string;
+    provider: ImageProvider;
 } | null;
 export declare function imagesAvailable(): boolean;
-/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). */
-export declare function generateBackgrounds(dir: string, conceptKey: string, prompt: string, ratios?: string[], log?: (s: string) => void): Promise<Record<string, string | null>>;
+export declare const isMockGen: () => boolean;
+export type ImageResult = {
+    file: string;
+    costKrw: number;
+    model: string;
+};
+/** 이미지 한 장 — 파일로 저장 · 원가(원) 반환. 실패는 예외(fatal 이면 재시도 없이) */
+export declare function generateImage(opts: {
+    file: string;
+    prompt: string;
+    ratio: string;
+    model?: string;
+    refs?: string[];
+    log?: (s: string) => void;
+    quality?: 'low' | 'medium' | 'high';
+}): Promise<ImageResult>;
+/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). 원가는 onAsset 으로 알린다. */
+export declare function generateBackgrounds(dir: string, conceptKey: string, prompt: string, ratios?: string[], log?: (s: string) => void, opts?: {
+    model?: string;
+    refs?: string[];
+    variant?: string;
+    onAsset?: (a: {
+        ratio: string;
+        file: string;
+        costKrw: number;
+        model: string;
+    }) => void | Promise<void>;
+}): Promise<Record<string, string | null>>;
 /** 사용자 이미지 폴더 → 비율별 배경 매핑(가장 가까운 비율) */
 export declare function userBackgrounds(folder: string, conceptKey: string): Record<string, string | null>;

package/dist/core/creatives/images.js

@@ -1,79 +1,148 @@
-// 배경 이미지 — OpenAI Images(gpt-image)로 비율 4종 생성. 키가 없으면 null → 렌더러가 브랜드 그래디언트로 대신한다. 사용자가 준 이미지(--images 폴더)도 그대로 배경으로 쓴다.
+// 배경·키비주얼 이미지 — BizRouter 이미지 API(OpenAI Images 호환 · gemini/gpt-image 최신 모델 전부 한 키)로 비율 4종 생성.
+//   기본 모델은 media.ts 의 티어(economy=gemini-3.1-flash-lite-image · standard=gemini-3.1-flash-image · premium=gemini-3-pro-image).
+//   참고 이미지(guided)가 있으면 /v1/images/edits(multipart image[]) 로 그 인물·제품·화풍을 유지한다.
+//   응답 usage.cost(원) 가 원가 — 호출자가 ×1.1 로 청구한다. 키가 없으면 null → 렌더러가 브랜드 그래디언트로 대신한다.
+//   BizRouter 키가 없고 OPENAI_API_KEY 만 있으면 OpenAI 직행(gpt-image · size 만 지원 · 원가는 추정치).
+//   ADPILOT_MOCK_GEN=1 이면 API 없이 단색 PNG 를 만든다(e2e).
 import fs from 'node:fs';
 import path from 'node:path';
+import { Resvg } from '@resvg/resvg-js';
 import { loadConfig } from '../state.js';
+import { llmConfig } from '../llm.js';
 import { BG_RATIOS } from './specs.js';
+import { IMAGE_MODELS } from './media.js';
 export function imageConfig() {
     const c = loadConfig().image || {};
-    const key = process.env.ADPILOT_IMAGE_KEY || process.env.OPENAI_API_KEY || c.apiKey;
-    if (!key)
-        return null;
-    return { key, model: process.env.ADPILOT_IMAGE_MODEL || c.model || 'gpt-image-2.5-flare' };
+    const llm = llmConfig();
+    const brKey = process.env.ADPILOT_IMAGE_KEY || (c.provider !== 'openai' ? c.apiKey : undefined) || (llm && /bizrouter/.test(llm.base) ? llm.key : undefined);
+    if (brKey)
+        return { key: brKey, base: (process.env.ADPILOT_IMAGE_BASE_URL || c.baseUrl || 'https://api.bizrouter.ai').replace(/\/+$/, ''), model: process.env.ADPILOT_IMAGE_MODEL || c.model || IMAGE_MODELS.economy.model, provider: 'bizrouter' };
+    const oa = process.env.OPENAI_API_KEY || (c.provider === 'openai' ? c.apiKey : undefined);
+    if (oa)
+        return { key: oa, base: 'https://api.openai.com', model: process.env.ADPILOT_IMAGE_MODEL || 'gpt-image-2.5-flare', provider: 'openai' };
+    return null;
 }
-export function imagesAvailable() { return imageConfig() !== null; }
+export function imagesAvailable() { return process.env.ADPILOT_MOCK_GEN === '1' || imageConfig() !== null; }
+export const isMockGen = () => process.env.ADPILOT_MOCK_GEN === '1';
 const STYLE = 'Premium advertising key visual, cinematic, editorial quality, photoreal render or refined abstract. ABSOLUTELY NO text, letters, numbers, logos, watermarks, UI, or real people\'s faces. Composition leaves large calm negative space for a headline overlay.';
-/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). */
-export async function generateBackgrounds(dir, conceptKey, prompt, ratios = Object.keys(BG_RATIOS), log = () => { }) {
+const REF_STYLE = 'Use the attached reference image(s) as the source of truth for the product, character, and visual style — keep them recognizable and consistent. Do not add text, logos, or watermarks.';
+const gptSize = (ratio) => (ratio === '16x9' ? '1536x1024' : ratio === '1x1' ? '1024x1024' : '1024x1536');
+const isGpt = (model) => /gpt-image|grok-imagine-image/.test(model);
+/** 모의 이미지 — 비율에 맞는 그래디언트 PNG */
+function mockPng(file, ratio, seed) {
+    const [w, h] = (BG_RATIOS[ratio]?.openai || '1024x1024').split('x').map(Number);
+    let n = 0;
+    for (const ch of seed)
+        n = (n * 31 + ch.charCodeAt(0)) >>> 0;
+    const hue = n % 360;
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="hsl(${hue},60%,35%)"/><stop offset="1" stop-color="hsl(${(hue + 60) % 360},70%,55%)"/></linearGradient></defs><rect width="${w}" height="${h}" fill="url(#g)"/><circle cx="${w * 0.7}" cy="${h * 0.35}" r="${Math.min(w, h) * 0.22}" fill="rgba(255,255,255,.18)"/></svg>`;
+    fs.writeFileSync(file, new Resvg(svg).render().asPng());
+}
+/** 이미지 한 장 — 파일로 저장 · 원가(원) 반환. 실패는 예외(fatal 이면 재시도 없이) */
+export async function generateImage(opts) {
+    const log = opts.log || (() => { });
+    if (isMockGen()) {
+        mockPng(opts.file, opts.ratio, opts.prompt + opts.ratio);
+        return { file: opts.file, costKrw: 50, model: 'mock' };
+    }
     const cfg = imageConfig();
+    if (!cfg)
+        throw Object.assign(new Error('이미지 생성 키가 없어요'), { fatal: true });
+    let model = opts.model || cfg.model;
+    if (cfg.provider === 'openai' && !isGpt(model))
+        model = 'gpt-image-2.5-flare';
+    const refs = (opts.refs || []).filter((f) => fs.existsSync(f)).slice(0, 6);
+    const prompt = refs.length ? `${opts.prompt} ${REF_STYLE} ${STYLE.replace('ABSOLUTELY NO text', 'No text')}` : `${opts.prompt} ${STYLE}`;
+    const aspect = BG_RATIOS[opts.ratio]?.aspect || '1:1';
+    let lastErr;
+    for (let attempt = 0; attempt < 4; attempt++) {
+        try {
+            let res;
+            if (refs.length && cfg.provider === 'bizrouter') {
+                const fd = new FormData();
+                fd.set('model', model);
+                fd.set('prompt', prompt);
+                fd.set('output_format', 'png');
+                if (isGpt(model)) {
+                    fd.set('size', gptSize(opts.ratio));
+                    fd.set('quality', opts.quality || 'medium');
+                }
+                else
+                    fd.set('aspect_ratio', aspect);
+                for (const f of refs)
+                    fd.append('image[]', new Blob([fs.readFileSync(f)], { type: /\.png$/i.test(f) ? 'image/png' : /\.webp$/i.test(f) ? 'image/webp' : 'image/jpeg' }), path.basename(f));
+                res = await fetch(`${cfg.base}/v1/images/edits`, { method: 'POST', headers: { authorization: `Bearer ${cfg.key}` }, body: fd, signal: AbortSignal.timeout(300_000) });
+            }
+            else {
+                const body = { model, prompt, output_format: 'png', n: 1 };
+                if (isGpt(model) || cfg.provider === 'openai') {
+                    body.size = gptSize(opts.ratio);
+                    body.quality = opts.quality || 'medium';
+                    if (cfg.provider === 'openai')
+                        delete body.output_format;
+                }
+                else
+                    body.aspect_ratio = aspect;
+                res = await fetch(`${cfg.base}/v1/images/generations`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify(body), signal: AbortSignal.timeout(300_000) });
+            }
+            if (!res.ok) {
+                const t = await res.text();
+                if (res.status === 400 && /model|not found|does not exist/i.test(t) && model !== IMAGE_MODELS.economy.model && cfg.provider === 'bizrouter') {
+                    log(`  모델 ${model} 을 쓸 수 없어 ${IMAGE_MODELS.economy.model} 로`);
+                    model = IMAGE_MODELS.economy.model;
+                    continue;
+                }
+                if (res.status === 400 || res.status === 401 || res.status === 403 || res.status === 402)
+                    throw Object.assign(new Error(`${res.status} ${t.slice(0, 200)}`), { fatal: true });
+                throw new Error(`${res.status} ${t.slice(0, 200)}`);
+            }
+            const d = (await res.json());
+            if (d.error)
+                throw Object.assign(new Error(d.error.message || '이미지 응답 오류'), { fatal: true });
+            const b64 = d.data?.[0]?.b64_json;
+            if (b64)
+                fs.writeFileSync(opts.file, Buffer.from(b64, 'base64'));
+            else if (d.data?.[0]?.url)
+                fs.writeFileSync(opts.file, Buffer.from(await (await fetch(d.data[0].url)).arrayBuffer()));
+            else
+                throw new Error('이미지 응답이 비었어요');
+            const costKrw = typeof d.usage?.cost === 'number' ? d.usage.cost : cfg.provider === 'openai' ? 180 : (Object.values(IMAGE_MODELS).find((m) => m.model === model)?.unitKrw ?? 100);
+            return { file: opts.file, costKrw, model };
+        }
+        catch (e) {
+            lastErr = e;
+            if (e.fatal)
+                throw e;
+            log(`  이미지 생성 재시도 (${e instanceof Error ? e.message.slice(0, 120) : e})`);
+            await new Promise((r) => setTimeout(r, 3000 * (attempt + 1)));
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). 원가는 onAsset 으로 알린다. */
+export async function generateBackgrounds(dir, conceptKey, prompt, ratios = Object.keys(BG_RATIOS), log = () => { }, opts = {}) {
     const out = {};
+    const available = imagesAvailable();
     const one = async (r) => {
-        const file = path.join(dir, `bg_${conceptKey}_${r}.png`);
+        const file = path.join(dir, `bg_${conceptKey}${opts.variant ? `_${opts.variant}` : ''}_${r}.png`);
         if (fs.existsSync(file)) {
             out[r] = file;
             return;
         }
-        if (!cfg) {
+        if (!available) {
             out[r] = null;
             return;
         }
-        let size = BG_RATIOS[r].openai;
-        let model = cfg.model;
-        const FALLBACK = ['gpt-image-2.5-flare', 'gpt-image-2', 'gpt-image-1.5', 'gpt-image-1'];
-        for (let attempt = 0; attempt < 5; attempt++) {
-            try {
-                const res = await fetch('https://api.openai.com/v1/images/generations', { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model, prompt: `${prompt} ${STYLE}`, size, quality: 'high', n: 1 }), signal: AbortSignal.timeout(300_000) });
-                if (!res.ok) {
-                    const t = await res.text();
-                    if (res.status === 400 && /does not exist|model/i.test(t) && /model/i.test(t) && !/size/i.test(t)) {
-                        const next = FALLBACK.find((m) => m !== model && FALLBACK.indexOf(m) > FALLBACK.indexOf(model)) || FALLBACK.find((m) => m !== model);
-                        if (next) {
-                            log(`  ${conceptKey} ${r}: 모델 ${model} 없음 → ${next}`);
-                            model = next;
-                            continue;
-                        }
-                    }
-                    if (res.status === 400 && /size/i.test(t) && size !== '1024x1024') {
-                        log(`  ${conceptKey} ${r}: 이 모델은 ${size} 를 지원하지 않아요 → 1024x1024`);
-                        size = '1024x1024';
-                        continue;
-                    }
-                    if (res.status === 400 || res.status === 401 || res.status === 403)
-                        throw Object.assign(new Error(`${res.status} ${t.slice(0, 200)}`), { fatal: true });
-                    throw new Error(`${res.status} ${t.slice(0, 200)}`);
-                }
-                const d = (await res.json());
-                const b64 = d.data[0]?.b64_json;
-                if (b64)
-                    fs.writeFileSync(file, Buffer.from(b64, 'base64'));
-                else if (d.data[0]?.url)
-                    fs.writeFileSync(file, Buffer.from(await (await fetch(d.data[0].url)).arrayBuffer()));
-                else
-                    throw new Error('이미지 응답이 비었어요');
-                out[r] = file;
-                log(`  배경 ${conceptKey} ${r} ✓`);
-                return;
-            }
-            catch (e) {
-                if (e.fatal) {
-                    log(`  ${conceptKey} ${r}: 이미지 생성 실패 — ${e.message.slice(0, 160)} (브랜드 그래디언트로 대체)`);
-                    out[r] = null;
-                    return;
-                }
-                log(`  ${conceptKey} ${r}: 이미지 생성 재시도 (${e instanceof Error ? e.message.slice(0, 120) : e})`);
-                await new Promise((r2) => setTimeout(r2, 3000 * (attempt + 1)));
-            }
+        try {
+            const res = await generateImage({ file, prompt, ratio: r, model: opts.model, refs: opts.refs, log });
+            out[r] = file;
+            log(`  배경 ${conceptKey}${opts.variant ? `/${opts.variant}` : ''} ${r} ✓ (₩${Math.round(res.costKrw)})`);
+            await opts.onAsset?.({ ratio: r, file, costKrw: res.costKrw, model: res.model });
+        }
+        catch (e) {
+            log(`  ${conceptKey} ${r}: 이미지 생성 실패 — ${e.message.slice(0, 160)} (브랜드 그래디언트로 대체)`);
+            out[r] = null;
         }
-        out[r] = null;
     };
     await Promise.all(ratios.map(one));
     return out;

package/dist/core/creatives/media.d.ts

@@ -0,0 +1,118 @@
+import type { Medium } from '../../adapters/types.js';
+import { type Tone, type VideoFormat } from './playbook.js';
+export type CreativeMode = 'auto' | 'image' | 'video' | 'text';
+export type CreativeSource = 'ai' | 'guided' | 'manual';
+export type Tier = 'economy' | 'standard' | 'premium';
+export type VideoRatio = '9x16' | '16x9' | '1x1' | '4x5';
+export type VideoProvider = 'auto' | 'veo' | 'seedance';
+export type VideoDuration = 8 | 15 | 30;
+export type CreativeSpec = {
+    mode?: CreativeMode;
+    source?: CreativeSource;
+    /** guided: 요구사항·방향(자연어). manual 에서도 참고용으로 남는다 */
+    prompt?: string;
+    /** 컨셉(방향) 수 1~5 — 비우면 모드별 기본 */
+    concepts?: number;
+    images?: {
+        tier?: Tier;
+        variants?: number;
+    };
+    /** 톤 다이얼(차분/활기/강하게) — 비우면 업종 플레이북 기본 */
+    tone?: Tone;
+    video?: {
+        count?: number; /** 포맷 지정(비우면 플레이북·장르·화면 유무로 자동) */
+        formats?: VideoFormat[];
+        durationSec?: VideoDuration;
+        ratios?: VideoRatio[];
+        audio?: boolean;
+        tier?: Tier;
+        captions?: boolean;
+        endCard?: boolean;
+        provider?: VideoProvider;
+        resolution?: '720p' | '1080p';
+    };
+    /** manual: 광고주가 직접 올린 문구 */
+    copy?: {
+        headlines?: string[];
+        bodies?: string[];
+        descriptions?: string[];
+    };
+};
+export type VideoJob = {
+    ratio: VideoRatio;
+    durationSec: number;
+    provider: 'veo' | 'seedance';
+    model: string;
+    resolution: '720p' | '1080p';
+    audio: boolean;
+    captions: boolean;
+    endCard: boolean;
+    unitKrw: number; /** 콘티 포맷(영상 1편 = 포맷 1개) */
+    format?: VideoFormat;
+};
+export type CreativePlan = {
+    mode: CreativeMode;
+    source: CreativeSource;
+    concepts: number;
+    tone: Tone;
+    formats: VideoFormat[];
+    images: {
+        enabled: boolean;
+        tier: Tier;
+        model: string;
+        variants: number;
+        ratios: string[];
+        unitKrw: number;
+    };
+    videos: {
+        perConcept: VideoJob[];
+        conceptsWithVideo: number;
+    };
+    estimate: {
+        imagesKrw: number;
+        videosKrw: number;
+        totalKrw: number;
+        chargedKrw: number;
+        lines: string[];
+    };
+    explain: string;
+};
+/** 청구 = 원가 × 1.1 (사장님 정의 · 원 단위 올림) */
+export declare const CREATIVE_MARKUP = 1.1;
+export declare const chargeFor: (costKrw: number) => number;
+/** 달러 → 원. BizRouter 모델표가 쓰는 환율(1436)과 맞춘다 · 환경변수로 덮어쓸 수 있다 */
+export declare const USD_KRW: () => number;
+export declare const IMAGE_MODELS: Record<Tier, {
+    model: string;
+    unitKrw: number;
+}>;
+/** 영상 초당 원가(원) — 8초 이하는 Veo(BizRouter 한 키) · 15/30초는 Seedance 2.5(ARK) */
+export declare const VIDEO_MODELS: Record<string, {
+    provider: 'veo' | 'seedance';
+    perSecKrw: Record<'720p' | '1080p', number>;
+    maxSec: number;
+    ratios: VideoRatio[];
+}>;
+export declare function pickVideoModel(durationSec: number, tier: Tier, provider?: VideoProvider, ratio?: VideoRatio): string;
+export declare const MODE_LABEL: Record<CreativeMode, string>;
+export declare const SOURCE_LABEL: Record<CreativeSource, string>;
+/**
+ * 설정 + 예산 → 실행 계획. 온라인 광고 소재의 일반 배합:
+ *  - 이미지는 컨셉마다 비율 4종(1:1·4:5·9:16·16:9) 배경을 만들어 12규격으로 합성(기존) · 「이미지 위주」는 배경 2세트(A/B)
+ *  - 영상은 9:16(릴스·스토리·쇼츠) 8초가 기본 · 「영상 위주」는 16:9(피드·유튜브) 추가 · 1:1/4:5 는 9:16 에서 무료로 잘라 만든다
+ *  - 소리(모델 네이티브 BGM·효과음·대사)는 기본 켬 · 자막(헤드라인 번인)·엔드카드(로고·CTA 2초)는 기본 켬
+ *  - 예산이 작으면(월 50만 미만) 영상은 대표 컨셉 1개에만 · 월 200만 이상이면 표준 화질(Veo fast)
+ */
+export declare function resolveCreativePlan(spec: CreativeSpec | undefined, ctx: {
+    monthlyKrw: number;
+    media: Medium[];
+    industry?: string | null;
+    genres?: string[];
+    hasScreens?: boolean;
+}): CreativePlan;
+/** 9:16 원본에서 무료로 파생할 비율(메타 피드 4:5·1:1) */
+export declare const DERIVED_RATIOS: Record<VideoRatio, VideoRatio[]>;
+export declare const VIDEO_DIMS: Record<VideoRatio, {
+    w: number;
+    h: number;
+}>;

package/dist/core/creatives/media.js

@@ -0,0 +1,91 @@
+import { pickFormats, playbookFor } from './playbook.js';
+/** 청구 = 원가 × 1.1 (사장님 정의 · 원 단위 올림) */
+export const CREATIVE_MARKUP = 1.1;
+export const chargeFor = (costKrw) => Math.ceil(Math.max(0, costKrw) * CREATIVE_MARKUP);
+/** 달러 → 원. BizRouter 모델표가 쓰는 환율(1436)과 맞춘다 · 환경변수로 덮어쓸 수 있다 */
+export const USD_KRW = () => Number(process.env.USD_KRW || 1436);
+export const IMAGE_MODELS = {
+    economy: { model: 'google/gemini-3.1-flash-lite-image', unitKrw: 55 },
+    standard: { model: 'google/gemini-3.1-flash-image', unitKrw: 105 },
+    premium: { model: 'google/gemini-3-pro-image', unitKrw: 240 },
+};
+/** 영상 초당 원가(원) — 8초 이하는 Veo(BizRouter 한 키) · 15/30초는 Seedance 2.5(ARK) */
+export const VIDEO_MODELS = {
+    'google/veo-3.1-lite': { provider: 'veo', perSecKrw: { '720p': 72, '1080p': 115 }, maxSec: 8, ratios: ['9x16', '16x9'] },
+    'google/veo-3.1-fast': { provider: 'veo', perSecKrw: { '720p': 144, '1080p': 173 }, maxSec: 8, ratios: ['9x16', '16x9'] },
+    'google/veo-3.1': { provider: 'veo', perSecKrw: { '720p': 575, '1080p': 575 }, maxSec: 8, ratios: ['9x16', '16x9'] },
+    'dreamina-seedance-2-5-260628': { provider: 'seedance', perSecKrw: { '720p': 335, '1080p': 820 }, maxSec: 30, ratios: ['9x16', '16x9', '1x1', '4x5'] },
+};
+const VEO_BY_TIER = { economy: 'google/veo-3.1-lite', standard: 'google/veo-3.1-fast', premium: 'google/veo-3.1' };
+export function pickVideoModel(durationSec, tier, provider = 'auto', ratio = '9x16') {
+    if (provider === 'seedance')
+        return 'dreamina-seedance-2-5-260628';
+    if (provider === 'veo')
+        return VEO_BY_TIER[tier];
+    // auto: 8초·9:16/16:9 는 Veo(싸고 한 키) · 그 외(15/30초 · 1:1·4:5 원본)는 Seedance
+    if (durationSec <= 8 && (ratio === '9x16' || ratio === '16x9'))
+        return VEO_BY_TIER[tier];
+    return 'dreamina-seedance-2-5-260628';
+}
+const FORMAT_LABEL_SHORT = { ugc_selfie: '셀카 후기', ui_demo: '화면 데모', cinematic: '시네마틱', product_hero: '제품', lifestyle: '라이프스타일', text_hook: '글자 훅' };
+export const MODE_LABEL = { auto: '알아서(추천)', image: '이미지 위주', video: '영상 위주', text: '글·링크 위주' };
+export const SOURCE_LABEL = { ai: 'AI가 전부 만들기', guided: '내 요구사항·참고 이미지로', manual: '직접 올린 소재로' };
+/**
+ * 설정 + 예산 → 실행 계획. 온라인 광고 소재의 일반 배합:
+ *  - 이미지는 컨셉마다 비율 4종(1:1·4:5·9:16·16:9) 배경을 만들어 12규격으로 합성(기존) · 「이미지 위주」는 배경 2세트(A/B)
+ *  - 영상은 9:16(릴스·스토리·쇼츠) 8초가 기본 · 「영상 위주」는 16:9(피드·유튜브) 추가 · 1:1/4:5 는 9:16 에서 무료로 잘라 만든다
+ *  - 소리(모델 네이티브 BGM·효과음·대사)는 기본 켬 · 자막(헤드라인 번인)·엔드카드(로고·CTA 2초)는 기본 켬
+ *  - 예산이 작으면(월 50만 미만) 영상은 대표 컨셉 1개에만 · 월 200만 이상이면 표준 화질(Veo fast)
+ */
+export function resolveCreativePlan(spec, ctx) {
+    const s = spec || {};
+    const mode = s.mode || 'auto';
+    const source = s.source || 'ai';
+    const small = ctx.monthlyKrw < 500_000;
+    const concepts = Math.max(1, Math.min(5, s.concepts || (source === 'manual' ? 1 : mode === 'text' ? 4 : 3)));
+    const imgTier = s.images?.tier || (ctx.monthlyKrw >= 3_000_000 ? 'standard' : 'economy');
+    const imagesEnabled = source !== 'manual' && mode !== 'text';
+    const variants = Math.max(1, Math.min(3, s.images?.variants || (mode === 'image' ? 2 : 1)));
+    const ratios = ['1x1', '4x5', '9x16', '16x9'];
+    const vTier = s.video?.tier || (ctx.monthlyKrw >= 2_000_000 ? 'standard' : 'economy');
+    const duration = s.video?.durationSec || 8;
+    const wantVideo = source !== 'manual' && s.video?.count !== 0 && (mode === 'auto' || mode === 'video' || (s.video?.count || 0) > 0) && mode !== 'text' && mode !== 'image';
+    const vRatios = s.video?.ratios?.length ? s.video.ratios : ['9x16'];
+    const pb = playbookFor(ctx.industry);
+    const tone = s.tone || pb.tone;
+    // 영상 1편 = 콘티 포맷 1개 — 「알아서」는 2포맷(예 셀카 후기 + 장르 시네마틱) · 「영상 위주」는 3포맷. 매체가 포맷 성과를 비교한다.
+    const fmtCount = s.video?.count ?? (mode === 'video' ? 3 : 2);
+    const formats = wantVideo ? pickFormats({ industry: ctx.industry, genres: ctx.genres, hasScreens: ctx.hasScreens ?? true, count: Math.max(1, Math.min(4, fmtCount)), requested: s.video?.formats }) : [];
+    const count = wantVideo ? formats.length : 0;
+    const resolution = s.video?.resolution || '720p';
+    const perConcept = [];
+    for (let i = 0; i < count; i++) {
+        const ratio = vRatios[i % vRatios.length];
+        const model = pickVideoModel(duration, vTier, s.video?.provider || 'auto', ratio);
+        const m = VIDEO_MODELS[model];
+        const sec = Math.min(duration, m.maxSec);
+        // ui_demo 는 8초 중 4초만 생성(나머지는 실제 화면 · 무료)
+        const genSec = formats[i] === 'ui_demo' && sec <= 8 && (ctx.hasScreens ?? true) ? Math.round(sec / 2) : sec;
+        perConcept.push({ ratio, durationSec: sec, provider: m.provider, model, resolution, audio: s.video?.audio ?? true, captions: s.video?.captions ?? true, endCard: s.video?.endCard ?? true, unitKrw: Math.round(m.perSecKrw[resolution] * genSec), format: formats[i] });
+    }
+    const conceptsWithVideo = count ? (small && mode !== 'video' ? 1 : concepts) : 0;
+    const img = IMAGE_MODELS[imgTier];
+    const imagesKrw = imagesEnabled ? concepts * variants * ratios.length * img.unitKrw : 0;
+    const videosKrw = conceptsWithVideo * perConcept.reduce((n, v) => n + v.unitKrw, 0);
+    const totalKrw = imagesKrw + videosKrw;
+    const lines = [];
+    if (imagesEnabled)
+        lines.push(`이미지 배경 ${concepts * variants * ratios.length}장(방향 ${concepts} × 세트 ${variants} × 비율 4) ≈ ₩${imagesKrw.toLocaleString()} → 12가지 크기로 합성(합성은 무료)`);
+    else if (source === 'manual')
+        lines.push('이미지·영상은 올려 주신 것을 그대로 써요(생성 비용 0)');
+    else
+        lines.push('이미지 생성 없이 브랜드 색 배경 + 문구로 만들어요(비용 0)');
+    if (conceptsWithVideo)
+        lines.push(`영상 ${conceptsWithVideo * perConcept.length}편(방향 ${conceptsWithVideo} × 포맷 ${perConcept.map((v) => `${FORMAT_LABEL_SHORT[v.format || 'cinematic']} ${v.durationSec}초`).join('·')}) ≈ ₩${videosKrw.toLocaleString()}${perConcept.some((v) => v.audio) ? ' · 소리 포함' : ''} · 4:5·1:1 파생 무료`);
+    lines.push(`예상 원가 ₩${totalKrw.toLocaleString()} → 청구 ₩${chargeFor(totalKrw).toLocaleString()}(원가의 1.1배 · 실제 생성된 것만, 만들어진 뒤 정확한 원가로 차감)`);
+    const explain = [`소재 형태: ${MODE_LABEL[mode]} · 출처: ${SOURCE_LABEL[source]} · 톤: ${tone} · 업종 플레이북: ${pb.label}`, ...lines].join('\n');
+    return { mode, source, concepts, tone, formats, images: { enabled: imagesEnabled, tier: imgTier, model: img.model, variants, ratios, unitKrw: img.unitKrw }, videos: { perConcept, conceptsWithVideo }, estimate: { imagesKrw, videosKrw, totalKrw, chargedKrw: chargeFor(totalKrw), lines }, explain };
+}
+/** 9:16 원본에서 무료로 파생할 비율(메타 피드 4:5·1:1) */
+export const DERIVED_RATIOS = { '9x16': ['4x5', '1x1'], '16x9': ['1x1'], '1x1': [], '4x5': [] };
+export const VIDEO_DIMS = { '9x16': { w: 1080, h: 1920 }, '16x9': { w: 1920, h: 1080 }, '1x1': { w: 1080, h: 1080 }, '4x5': { w: 1080, h: 1350 } };