adyou 0.3.0 → 0.4.0

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,108 @@
+import type { Medium } from '../../adapters/types.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;
+    };
+    video?: {
+        count?: number;
+        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;
+};
+export type CreativePlan = {
+    mode: CreativeMode;
+    source: CreativeSource;
+    concepts: number;
+    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[];
+}): 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,82 @@
+/** 청구 = 원가 × 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';
+}
+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' && (mode === 'auto' || mode === 'video' || (s.video?.count || 0) > 0) && mode !== 'text' && mode !== 'image';
+    const vRatios = s.video?.ratios?.length ? s.video.ratios : mode === 'video' ? ['9x16', '16x9'] : ['9x16'];
+    const count = wantVideo ? Math.max(0, Math.min(4, s.video?.count ?? vRatios.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);
+        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] * sec) });
+    }
+    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) => `${v.ratio.replace('x', ':')} ${v.durationSec}초`).join('·')}) ≈ ₩${videosKrw.toLocaleString()}${perConcept.some((v) => v.audio) ? ' · 소리 포함' : ''}`);
+    lines.push(`예상 원가 ₩${totalKrw.toLocaleString()} → 청구 ₩${chargeFor(totalKrw).toLocaleString()}(원가의 1.1배 · 실제 생성된 것만, 만들어진 뒤 정확한 원가로 차감)`);
+    const explain = [`소재 형태: ${MODE_LABEL[mode]} · 출처: ${SOURCE_LABEL[source]}`, ...lines].join('\n');
+    return { mode, source, concepts, 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 } };

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

@@ -6,6 +6,10 @@ export declare function loadFonts(): Promise<{
     weight: 400 | 500 | 700 | 800;
     style: 'normal';
 }[]>;
+/** 🔴 확장자가 아니라 바이트로 MIME 판별 — Gemini 이미지 API 는 .png 요청에도 JPEG 를 돌려준다(2026-09-16 실측 · 잘못된 MIME 이면 satori 가 배경을 조용히 버림) */
+export declare function sniffMime(buf: Buffer): string;
+declare const dataUri: (file: string) => string;
+export { dataUri };
 type El = {
     type: string;
     props: Record<string, unknown>;
@@ -22,4 +26,8 @@ export declare function renderConcept(dir: string, brief: Brief, concept: Concep
 }): Promise<CreativeAsset[]>;
 /** 구글 RDA 로고 자산 — 사이트 로고가 있으면 그것을, 없으면 회사명 텍스트 로고를 1:1(512)·4:1(1200×300)로 만든다 */
 export declare function renderLogo(dir: string, brief: Brief): Promise<CreativeAsset[]>;
-export {};
+/** 영상 자막 오버레이 — 투명 PNG(영상 크기) 에 하단 자막 알약 또는 CTA 버튼. ffmpeg drawtext(폰트 빌드 의존) 대신 satori 로 그린다. */
+export declare function renderOverlay(file: string, w: number, hh: number, text: string, o: {
+    kind: 'line' | 'cta';
+    primary: string;
+}): Promise<string>;

package/dist/core/creatives/render.js

@@ -28,7 +28,14 @@ export async function loadFonts() {
     }
     return out;
 }
-const dataUri = (file) => { const ext = path.extname(file).slice(1).toLowerCase(); return `data:image/${ext === 'jpg' ? 'jpeg' : ext};base64,${fs.readFileSync(file).toString('base64')}`; };
+/** 🔴 확장자가 아니라 바이트로 MIME 판별 — Gemini 이미지 API 는 .png 요청에도 JPEG 를 돌려준다(2026-09-16 실측 · 잘못된 MIME 이면 satori 가 배경을 조용히 버림) */
+export function sniffMime(buf) { if (buf[0] === 0x89 && buf[1] === 0x50)
+    return 'image/png'; if (buf[0] === 0xff && buf[1] === 0xd8)
+    return 'image/jpeg'; if (buf.subarray(0, 4).toString() === 'RIFF' && buf.subarray(8, 12).toString() === 'WEBP')
+    return 'image/webp'; if (/^\s*<(\?xml|svg)/.test(buf.subarray(0, 100).toString()))
+    return 'image/svg+xml'; return 'image/png'; }
+const dataUri = (file) => { const buf = fs.readFileSync(file); return `data:${sniffMime(buf)};base64,${buf.toString('base64')}`; };
+export { dataUri };
 async function fetchLogo(url, dir) {
     if (!url)
         return null;
@@ -155,3 +162,16 @@ export async function renderLogo(dir, brief) {
     }
     return out;
 }
+/** 영상 자막 오버레이 — 투명 PNG(영상 크기) 에 하단 자막 알약 또는 CTA 버튼. ffmpeg drawtext(폰트 빌드 의존) 대신 satori 로 그린다. */
+export async function renderOverlay(file, w, hh, text, o) {
+    const fonts = await loadFonts();
+    const base = Math.min(w, hh);
+    const fs1 = Math.round(base * (o.kind === 'cta' ? 0.055 : 0.068));
+    const pill = o.kind === 'cta'
+        ? h('div', { display: 'flex', fontSize: fs1, fontWeight: 700, color: '#fff', backgroundColor: o.primary, borderRadius: 999, padding: `${Math.round(fs1 * 0.55)}px ${Math.round(fs1 * 1.3)}px`, boxShadow: `0 10px 30px ${hexA(o.primary, 0.45)}` }, text)
+        : h('div', { display: 'flex', fontSize: fs1, fontWeight: 800, color: '#fff', backgroundColor: 'rgba(11,21,38,.62)', borderRadius: Math.round(fs1 * 0.4), padding: `${Math.round(fs1 * 0.35)}px ${Math.round(fs1 * 0.6)}px`, lineHeight: 1.25, letterSpacing: -1, textAlign: 'center', maxWidth: Math.round(w * 0.86), wordBreak: 'keep-all' }, text);
+    const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-end', justifyContent: 'center', paddingBottom: Math.round(hh * (o.kind === 'cta' ? 0.09 : 0.17)), fontFamily: 'Pretendard' }, [pill]);
+    const svg = await satori(el, { width: w, height: hh, fonts });
+    fs.writeFileSync(file, new Resvg(svg, { fitTo: { mode: 'width', value: w } }).render().asPng());
+    return file;
+}

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

@@ -0,0 +1,35 @@
+import { type VideoRatio } from './media.js';
+export type VideoGenInput = {
+    file: string;
+    prompt: string;
+    ratio: VideoRatio;
+    durationSec: number;
+    model: string;
+    resolution?: '720p' | '1080p';
+    audio?: boolean;
+    firstFrame?: string;
+    refs?: string[];
+    negative?: string;
+    log?: (s: string) => void;
+};
+export type VideoGenResult = {
+    file: string;
+    costKrw: number;
+    provider: 'veo' | 'seedance' | 'mock';
+    model: string;
+    durationSec: number;
+    opId?: string;
+};
+export declare function videoConfig(): {
+    veo?: {
+        base: string;
+        key: string;
+    };
+    seedance?: {
+        key: string;
+        base: string;
+    };
+};
+export declare function videoAvailable(provider?: 'veo' | 'seedance'): boolean;
+/** 영상 한 편 — 모델의 공급자로 라우팅. 실패는 예외(fatal 이면 재시도 없이 · costKrw 가 붙어 오면 그만큼은 원가 발생). */
+export declare function generateVideo(i: VideoGenInput): Promise<VideoGenResult>;