adyou 0.5.2 → 0.6.1

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

@@ -1,6 +1,8 @@
 import type { Brief, Concept, CreativeAsset, Goal } from '../state.js';
 import { type VideoJob, type VideoRatio } from './media.js';
 import { type Tone } from './playbook.js';
+/** 말하는 포맷의 음성 방식 — 영어만 Veo 네이티브 발화(실측 안정) · 그 외 언어는 TTS 내레이션(Veo 한국어·일본어 발화는 엉뚱한 대사 · 2026-09-16 사장님 검수) */
+export declare function speechModeFor(lang: string): 'native' | 'tts';
 export type VideoAsset = CreativeAsset & {
     type: 'video';
     costKrw: number;

package/dist/core/creatives/factory.js

@@ -4,12 +4,17 @@
 //   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 { DERIVED_RATIOS, VIDEO_DIMS, hasSeedance, speechVideoModel } 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, pickHookBand, probe, tailLoudnessDb, uiDemoClip } from './videofx.js';
+import { appendEndCard, burnCaptions, concatClips, deriveRatio, hasFfmpeg, kenBurnsClip, mixVoiceover, pickHookBand, probe, refCanvas, tailLoudnessDb, uiDemoClip } from './videofx.js';
+import { synthesizeSpeech, ttsAvailable } from './tts.js';
+import { isMockGen } from './images.js';
+import { checkFrames, checkProductMatch, checkSpeech } from './qa.js';
+/** 말하는 포맷의 음성 방식 — 영어만 Veo 네이티브 발화(실측 안정) · 그 외 언어는 TTS 내레이션(Veo 한국어·일본어 발화는 엉뚱한 대사 · 2026-09-16 사장님 검수) */
+export function speechModeFor(lang) { return lang.split('-')[0] === 'en' || hasSeedance() || !ttsAvailable() || isMockGen() ? 'native' : 'tts'; }
 /** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(언어별 문구) */
 export async function renderEndCard(dir, brief, concept, ratio, lang, backgrounds = {}) {
     try {
@@ -106,20 +111,35 @@ export async function produceConceptVideos(o) {
                     else {
                         const person = format === 'ugc_selfie';
                         const line = clip.speech ? (rl === board.lang ? clip.speech : lb0.speech || lb0.voice || clip.speech) : undefined;
+                        const mode = line ? speechModeFor(rl) : 'none';
                         // 대사는 클립 안에서 여유 있게 끝나야 한다 — 뚝 끊김 방지: 짧은 한 문장 · 마지막 1~1.5초는 말 없이 미소/끄덕임
-                        const speech = line ? ` The person speaks to camera in ${langName(rl)} (spoken language must be ${langName(rl)}, not English unless the line is English): "${line}". Natural lip sync, conversational, genuine, native-speaker accent. The line is short and finishes comfortably by second ${Math.max(3, clip.sec - 2)}; for the final 1.5 seconds the person is silent, smiling or nodding at the camera (no speech cut-off).` : '';
-                        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 speech = line && mode === 'native' ? ` The person speaks to camera in ${langName(rl)} (spoken language must be ${langName(rl)}): "${line}". Natural lip sync, conversational, genuine, native-speaker accent. The line is short and finishes comfortably by second ${Math.max(3, clip.sec - 2)}; for the final 1.5 seconds the person is silent, smiling or nodding at the camera (no speech cut-off).` : line ? ` The person does NOT speak at all — lips stay closed or in a natural smile; they react to the camera (nod, raised eyebrows, showing the product or their phone screen, a small laugh) like a silent vlog moment; a narrator voice-over will be added later. Audio: light background music only, no speech, no dialogue, no humming.` : '';
+                        const prompt = `${clip.prompt}${speech} Style: ${genreStyle(board.genre)}. Camera: ${tw.camera}. Audio: ${job.audio ? `${board.music || tw.music}${person && mode === 'native' ? ', clear voice over the music' : ''}` : 'silent'}. No on-screen text, no subtitles, no captions, no logos, no watermark.`;
+                        // 첫 프레임: 참고(제품) 사진이 있으면 그 사진을 캔버스에 앉힌 프레임(실제 제품이 움직임) · 없으면 생성 배경 · 사람 포맷은 없음
+                        let firstFrame = !person && ci === 0 ? (o.backgrounds[job.ratio] || undefined) : undefined;
+                        const refImg = !person && o.refs?.[0];
+                        if (refImg && ci === 0 && ff) {
+                            try {
+                                const stage = await renderPhoneStage(o.dir, dims.w, dims.h, o.brief.palette.primary, o.brief.palette.dark);
+                                firstFrame = await refCanvas(refImg, stage.bg, path.join(o.dir, `${key}_${rl}_refframe.png`), dims);
+                                log('  첫 프레임 = 올린 제품 사진');
+                            }
+                            catch { /* 생성 배경 유지 */ }
+                        }
+                        // 말하는 클립의 모델 — 영어 아닌 언어는 Seedance 네이티브 발화(립싱크) · 영어는 Veo
+                        const clipModel = line && mode === 'native' ? speechVideoModel(rl, job.model) : job.model;
+                        if (clipModel !== job.model)
+                            log(`  ${langName(rl)} 대사는 Seedance 2.5 네이티브 발화로(립싱크)`);
                         let r;
                         try {
-                            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 });
+                            r = await generateVideo({ file: cf, prompt, ratio: job.ratio, durationSec: clip.sec, model: clipModel, 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 });
                         }
                         catch (e) {
                             if (!e.retryable)
                                 throw e;
                             costKrw += Number(e.costKrw || 0);
                             log(`  안전 필터로 결과가 비어 와서 다른 테이크로 한 번 더 만들어요`);
-                            r = await generateVideo({ file: cf, prompt: `${prompt} Alternative take: different framing and wardrobe, softer lighting, keep everything family-friendly and brand-safe.`, ratio: job.ratio, durationSec: clip.sec, model: job.model, resolution: job.resolution, audio: job.audio, firstFrame, refs: undefined, negative: 'text, subtitles, letters, watermark, logo', log });
+                            r = await generateVideo({ file: cf, prompt: `${prompt} Alternative take: different framing and wardrobe, softer lighting, keep everything family-friendly and brand-safe.`, ratio: job.ratio, durationSec: clip.sec, model: clipModel, resolution: job.resolution, audio: job.audio, firstFrame, refs: undefined, negative: 'text, subtitles, letters, watermark, logo', log });
                         }
                         costKrw += r.costKrw;
                         // 대사 꼬리 검사 — 마지막 0.7초가 아직 시끄러우면(≥ -27dB) 말이 끝까지 이어진 것 → 더 짧은 대사로 1회 재생성(원가 1회 추가)
@@ -129,7 +149,7 @@ export async function produceConceptVideos(o) {
                                 log(`  대사가 끝까지 이어져요(꼬리 ${tail.toFixed(0)}dB) → 더 짧게 한 번 더 만들어요`);
                                 const short = line.split(/(?<=[.!?。！？])\s+/)[0] || line;
                                 try {
-                                    const r2 = await generateVideo({ file: cf, prompt: prompt.replace(`"${line}"`, `"${short}"`).replace('finishes comfortably by second', 'finishes clearly by second'), ratio: job.ratio, durationSec: clip.sec, model: job.model, resolution: job.resolution, audio: job.audio, firstFrame, refs: undefined, negative: 'text, subtitles, letters, watermark, logo', log });
+                                    const r2 = await generateVideo({ file: cf, prompt: prompt.replace(`"${line}"`, `"${short}"`).replace('finishes comfortably by second', 'finishes clearly by second'), ratio: job.ratio, durationSec: clip.sec, model: clipModel, resolution: job.resolution, audio: job.audio, firstFrame, refs: undefined, negative: 'text, subtitles, letters, watermark, logo', log });
                                     costKrw += r2.costKrw;
                                     const t2 = await tailLoudnessDb(cf, 0.7);
                                     log(`  다시 만든 컷 꼬리 ${t2.toFixed(0)}dB${t2 >= -27 ? ' (여전히 이어짐 · 그대로 사용)' : ' ✓'}`);
@@ -140,6 +160,40 @@ export async function produceConceptVideos(o) {
                             }
                         }
                         log(`  컷 ${ci + 1}/${board.clips.length} ${clip.sec}초 ✓ 원가 ₩${Math.round(r.costKrw).toLocaleString()}`);
+                        // QA ① 네이티브 대사: 언어·대본·끊김 검사 → 실패면 원본 소리를 낮추고 TTS 내레이션으로 대체
+                        if (line && mode === 'native' && ff && !isMockGen()) {
+                            const q = await checkSpeech(cf, { lang: rl, expected: line });
+                            log(`  ${q.note}`);
+                            if (!q.ok && ttsAvailable()) {
+                                try {
+                                    const v = await synthesizeSpeech({ text: line, lang: rl, file: path.join(o.dir, `${key}_${rl}_c${ci}_vo.mp3`), tone, persona: o.brief.audienceProfile?.persona });
+                                    const mixed = cf.replace(/\.mp4$/, '.vo.mp4');
+                                    await mixVoiceover(cf, v.file, mixed, { duck: 0.08 });
+                                    fs.copyFileSync(mixed, cf);
+                                    costKrw += v.costKrw;
+                                    log('  → TTS 내레이션으로 대체 ✓ (입모양은 안 맞을 수 있어요 · 자막 중심)');
+                                }
+                                catch (e) {
+                                    log(`  ⚠ TTS 대체 실패: ${e instanceof Error ? e.message.slice(0, 100) : e}`);
+                                }
+                            }
+                        }
+                        // QA ② 참고 제품 사진이 있으면 프레임의 제품이 같은지 → 다르면 사진 켄번즈(생성 위험 0)로 교체
+                        if (refImg && ff && !isMockGen()) {
+                            const q = await checkProductMatch(cf, refImg);
+                            log(`  ${q.note}`);
+                            if (!q.ok) {
+                                try {
+                                    const stage = await renderPhoneStage(o.dir, dims.w, dims.h, o.brief.palette.primary, o.brief.palette.dark);
+                                    const canvas = await refCanvas(refImg, stage.bg, path.join(o.dir, `${key}_${rl}_refframe.png`), dims);
+                                    await kenBurnsClip(canvas, cf, { sec: clip.sec, dims });
+                                    log('  → 제품 사진 켄번즈로 교체 ✓');
+                                }
+                                catch (e) {
+                                    log(`  ⚠ 교체 실패(생성 컷 사용): ${e instanceof Error ? e.message.slice(0, 100) : e}`);
+                                }
+                            }
+                        }
                     }
                     clipFiles.push(cf);
                 }
@@ -169,6 +223,33 @@ export async function produceConceptVideos(o) {
                 log(`  ⚠ 이어붙이기 실패(첫 컷만 사용): ${e instanceof Error ? e.message.slice(0, 120) : e}`);
                 fs.copyFileSync(clipFiles[0], rawFile);
             }
+            // TTS 내레이션(영어 외 시장의 말하는 포맷) — 번역된 대사를 그 언어 음성으로 얹는다
+            const ttsLine = board.clips.find((cl) => cl.kind === 'gen' && cl.speech) ? (rl === board.lang ? board.clips.find((cl) => cl.speech).speech : lb0.speech || lb0.voice) : undefined;
+            if (ttsLine && speechModeFor(rl) === 'tts' && ff) {
+                try {
+                    // 🔴 Veo 는 「대사 없이」 라고 해도 웅얼거리는 말을 넣는다(2026-09-16 실측 · TTS 와 겹쳐 들림) → 원본에 말소리가 있으면 원본 소리를 버리고 TTS 만, 음악만이면 낮춰서 깐다
+                    const sp = await checkSpeech(rawFile, { lang: rl, expected: '' });
+                    const hasSpeech = !sp.skipped && sp.data?.lang !== 'none';
+                    const v = await synthesizeSpeech({ text: ttsLine, lang: rl, file: path.join(o.dir, `${key}_${rl}_vo.mp3`), tone, persona: o.brief.audienceProfile?.persona });
+                    const mixed = rawFile.replace(/\.raw\.mp4$/, '.vo.raw.mp4');
+                    await mixVoiceover(rawFile, v.file, mixed, { duck: hasSpeech ? 0 : 0.3 });
+                    fs.copyFileSync(mixed, rawFile);
+                    costByLang[rl] = (costByLang[rl] || 0) + v.costKrw;
+                    log(`  ${langName(rl)} 내레이션(TTS) ${v.durationSec.toFixed(1)}초 얹음 ✓${hasSpeech ? ' (원본 말소리 감지 → 원본 소리 제거)' : ' (원본 음악 유지)'}`);
+                }
+                catch (e) {
+                    log(`  ⚠ 내레이션 실패(음악만): ${e instanceof Error ? e.message.slice(0, 100) : e}`);
+                }
+            }
+            // QA ③ 프레임 위생
+            if (ff) {
+                const q = await checkFrames(rawFile);
+                if (!q.ok) {
+                    log(`  ❌ ${q.note} — 이 포맷은 건너뜀`);
+                    fs.rmSync(rawFile, { force: true });
+                    continue;
+                }
+            }
         }
         // 3) 언어 × 비율 마감 — 원본(raw)에서 비율을 먼저 만들고 그 위에 자막·엔드카드
         for (const lang of langs) {

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

@@ -103,12 +103,16 @@ export declare const SOURCE_LABEL: Record<CreativeSource, string>;
  *  - 소리(모델 네이티브 BGM·효과음·대사)는 기본 켬 · 자막(헤드라인 번인)·엔드카드(로고·CTA 2초)는 기본 켬
  *  - 예산이 작으면(월 50만 미만) 영상은 대표 컨셉 1개에만 · 월 200만 이상이면 표준 화질(Veo fast)
  */
+/** 말하는 포맷(셀카 후기)의 음성 모델 — 영어는 Veo 네이티브 · 그 외는 Seedance 2.5 네이티브(한국어·일본어 립싱크 검증 · sosigi) · ARK 키 없으면 Veo(+TTS 내레이션 · 인물은 말 안 함) */
+export declare const hasSeedance: () => boolean;
+export declare function speechVideoModel(lang: string, fallback: string): string;
 export declare function resolveCreativePlan(spec: CreativeSpec | undefined, ctx: {
     monthlyKrw: number;
     media: Medium[];
     industry?: string | null;
     genres?: string[];
-    hasScreens?: boolean;
+    hasScreens?: boolean; /** 시장 언어(말하는 포맷 모델·원가 배정) */
+    langs?: string[];
 }): CreativePlan;
 /** 9:16 원본에서 무료로 파생할 비율(메타 피드 4:5·1:1) */
 export declare const DERIVED_RATIOS: Record<VideoRatio, VideoRatio[]>;

package/dist/core/creatives/media.js

@@ -28,7 +28,7 @@ export function pickVideoModel(durationSec, tier, provider = 'auto', ratio = '9x
     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 MODE_LABEL = { image: '이미지 + 문구(기본)', auto: '이미지 + 영상(베타)', video: '영상 위주(베타)', text: '글·링크 위주' };
 export const SOURCE_LABEL = { ai: 'AI가 전부 만들기', guided: '내 요구사항·참고 이미지로', manual: '직접 올린 소재로' };
 /**
  * 설정 + 예산 → 실행 계획. 온라인 광고 소재의 일반 배합:
@@ -37,9 +37,14 @@ export const SOURCE_LABEL = { ai: 'AI가 전부 만들기', guided: '내 요구
  *  - 소리(모델 네이티브 BGM·효과음·대사)는 기본 켬 · 자막(헤드라인 번인)·엔드카드(로고·CTA 2초)는 기본 켬
  *  - 예산이 작으면(월 50만 미만) 영상은 대표 컨셉 1개에만 · 월 200만 이상이면 표준 화질(Veo fast)
  */
+/** 말하는 포맷(셀카 후기)의 음성 모델 — 영어는 Veo 네이티브 · 그 외는 Seedance 2.5 네이티브(한국어·일본어 립싱크 검증 · sosigi) · ARK 키 없으면 Veo(+TTS 내레이션 · 인물은 말 안 함) */
+export const hasSeedance = () => !!process.env.ARK_API_KEY;
+export function speechVideoModel(lang, fallback) { return lang.split('-')[0] !== 'en' && hasSeedance() ? 'dreamina-seedance-2-5-260628' : fallback; }
+const SPEAKING_FORMATS = ['ugc_selfie'];
 export function resolveCreativePlan(spec, ctx) {
     const s = spec || {};
-    const mode = s.mode || 'auto';
+    // 기본 = 이미지 + 문구(안전) · 영상은 베타(광고주 선택) — 2026-09-16 사장님 결정
+    const mode = s.mode || 'image';
     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)));
@@ -49,7 +54,7 @@ export function resolveCreativePlan(spec, ctx) {
     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 wantVideo = source !== 'manual' && s.video?.count !== 0 && mode !== 'text' && (mode === 'auto' || mode === 'video' || (s.video?.count || 0) > 0 || (s.video?.formats?.length || 0) > 0);
     const vRatios = s.video?.ratios?.length ? s.video.ratios : ['9x16'];
     const pb = playbookFor(ctx.industry);
     const tone = s.tone || pb.tone;
@@ -66,7 +71,11 @@ export function resolveCreativePlan(spec, ctx) {
         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] });
+        // 말하는 포맷: 영어 아닌 시장 언어가 있으면 그 언어 클립은 Seedance 원가로(언어별 클립 · 언어 수만큼)
+        const langs = ctx.langs?.length ? ctx.langs : ['ko'];
+        const speaking = SPEAKING_FORMATS.includes(formats[i]);
+        const perLang = speaking ? langs.map((l) => { const mm = VIDEO_MODELS[speechVideoModel(l, model)]; return Math.round(mm.perSecKrw[resolution] * Math.min(sec, mm.maxSec)); }) : [Math.round(m.perSecKrw[resolution] * genSec)];
+        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: perLang.reduce((a, b) => a + b, 0), format: formats[i] });
     }
     const conceptsWithVideo = count ? (small && mode !== 'video' ? 1 : concepts) : 0;
     const img = IMAGE_MODELS[imgTier];

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

@@ -0,0 +1,5 @@
+export declare function listGatewayModels(): Promise<string[]>;
+/** 표(원가 있음)에 있는 모델 중 게이트웨이가 실제로 서비스하는 최신 — 표에 없으면 표의 기본을 그대로 */
+export declare function newestAvailable(candidates: string[], available: string[]): string;
+/** 게이트웨이 목록에 있으나 표에 없는 「더 새 버전」 — 로그로 알려 표를 갱신하게 */
+export declare function newerThanTable(available: string[]): string[];

package/dist/core/creatives/models.js

@@ -0,0 +1,35 @@
+// 모델 자동 선택 — BizRouter `/v1/models` 를 실행 때 읽어(1시간 캐시) Veo·Gemini 이미지의 최신 버전을 티어별로 고른다. 조회 실패면 media.ts 의 고정표.
+//   규칙: 같은 계열에서 버전 숫자가 가장 큰 것 · lite/fast/표준 접미사는 티어에 대응 · 가격표에 없는 새 모델은 원가를 모르니 「표에 있는 최신」만 쓴다(원가 추정 어긋남 방지 · 새 모델은 표 갱신으로 승격).
+import { imageConfig } from './images.js';
+import { IMAGE_MODELS, VIDEO_MODELS } from './media.js';
+let cache = null;
+export async function listGatewayModels() {
+    if (cache && Date.now() - cache.at < 3600_000)
+        return cache.ids;
+    const cfg = imageConfig();
+    if (!cfg || cfg.provider !== 'bizrouter')
+        return [];
+    try {
+        const r = await fetch(`${cfg.base}/v1/models`, { headers: { authorization: `Bearer ${cfg.key}` }, signal: AbortSignal.timeout(15_000) });
+        const j = (await r.json());
+        cache = { at: Date.now(), ids: (j.data || []).map((m) => m.id) };
+        return cache.ids;
+    }
+    catch {
+        return cache?.ids || [];
+    }
+}
+const ver = (id) => { const m = /(\d+(?:\.\d+)?)/.exec(id.split('/').pop() || ''); return m ? Number(m[1]) : 0; };
+/** 표(원가 있음)에 있는 모델 중 게이트웨이가 실제로 서비스하는 최신 — 표에 없으면 표의 기본을 그대로 */
+export function newestAvailable(candidates, available) {
+    const live = candidates.filter((c) => available.includes(c));
+    return (live.length ? live : candidates).sort((a, b) => ver(b) - ver(a))[0];
+}
+/** 게이트웨이 목록에 있으나 표에 없는 「더 새 버전」 — 로그로 알려 표를 갱신하게 */
+export function newerThanTable(available) {
+    const tableVeo = Object.keys(VIDEO_MODELS).filter((m) => /veo/.test(m));
+    const tableImg = Object.values(IMAGE_MODELS).map((m) => m.model);
+    const maxVeo = Math.max(...tableVeo.map(ver));
+    const maxImg = Math.max(...tableImg.map(ver));
+    return available.filter((id) => (/google\/veo-/.test(id) && ver(id) > maxVeo) || (/google\/gemini-.*-image$/.test(id) && ver(id) > maxImg));
+}

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

@@ -0,0 +1,22 @@
+export type QaResult = {
+    ok: boolean;
+    skipped?: boolean;
+    note: string;
+    data?: Record<string, unknown>;
+};
+export declare const speechQaAvailable: () => boolean;
+/** 대본 vs 전사 유사도 0~1 — 공백 언어는 단어 겹침 · CJK 는 글자 바이그램 겹침 */
+export declare function transcriptSimilarity(expected: string, transcript: string): number;
+/** 대사 검사 — 언어 일치 + 대본 유사도(≥0.35) + 끊김 아님 */
+export declare function checkSpeech(video: string, o: {
+    lang: string;
+    expected: string;
+}): Promise<QaResult>;
+/** 제품 일치 — 참고 사진 vs 프레임 2장(1초·중간) */
+export declare function checkProductMatch(video: string, refImage: string): Promise<QaResult>;
+/** 프레임 위생 — 길이·크기·검은 화면 비율 */
+export declare function checkFrames(video: string, minSec?: number): Promise<QaResult>;
+/** 사진에 실존 인물(얼굴)이 있나 — 사이트에서 자동으로 가져온 이미지는 연예인·모델 사진일 수 있어 참고 이미지로 쓰면 초상권 위험(2026-09-16 실측: 뷰티 사이트 대표 이미지가 아이돌) → 사람 없는 제품 사진만 통과 */
+export declare function containsPerson(image: string): Promise<boolean | null>;
+/** 자동 수집 이미지 중 사람 없는 것만(판정 불가면 제외 — 보수적) */
+export declare function filterProductRefs(files: string[], log?: (s: string) => void): Promise<string[]>;

package/dist/core/creatives/qa.js

@@ -0,0 +1,148 @@
+// 생성 소재 자동 QA — 영상 크레딧을 쓴 결과물을 사람 눈 대신 기계가 먼저 본다.
+//   ① 대사 검사: 소리를 Gemini 2.5 Flash 에 직접 보내(BizRouter 경유는 오디오 입력 불가 · GEMINI_API_KEY) 「어느 언어 · 전사 · 끊김」 → 언어 불일치·대본과 동떨어짐이면 실패
+//   ② 제품 일치: 참고(제품) 사진과 영상 프레임을 qwen 비전(BizRouter · 저가)에 나란히 보여 「같은 제품인가」 → 아니면 실패
+//   ③ 프레임 위생: 길이 0 · 검은 화면 · 크기 이상
+// 실패하면 호출자가 안전한 대체(TTS 내레이션·무음+자막·제품 사진 켄번즈)로 바꾼다. 키가 없으면 검사를 건너뛰고 skipped 로 표시(막지 않는다).
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { imageConfig } from './images.js';
+import { sniffMime } from './render.js';
+import { probe } from './videofx.js';
+const execFileP = promisify(execFile);
+const geminiKey = () => process.env.GEMINI_API_KEY || process.env.ADPILOT_QA_GEMINI_KEY;
+export const speechQaAvailable = () => !!geminiKey();
+const tokens = (t) => t.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, ' ').split(/\s+/).filter(Boolean);
+const bigrams = (t) => { const s = t.replace(/[^\p{L}\p{N}]/gu, ''); const out = new Set(); for (let i = 0; i < s.length - 1; i++)
+    out.add(s.slice(i, i + 2)); return out; };
+/** 대본 vs 전사 유사도 0~1 — 공백 언어는 단어 겹침 · CJK 는 글자 바이그램 겹침 */
+export function transcriptSimilarity(expected, transcript) {
+    const cjk = /[぀-ヿ㐀-鿿가-힯]/.test(expected);
+    if (cjk) {
+        const a = bigrams(expected), b = bigrams(transcript);
+        if (!a.size)
+            return 0;
+        let hit = 0;
+        for (const x of a)
+            if (b.has(x))
+                hit++;
+        return hit / a.size;
+    }
+    const a = tokens(expected), b = new Set(tokens(transcript));
+    if (!a.length)
+        return 0;
+    return a.filter((w) => b.has(w)).length / a.length;
+}
+/** 대사 검사 — 언어 일치 + 대본 유사도(≥0.35) + 끊김 아님 */
+export async function checkSpeech(video, o) {
+    const key = geminiKey();
+    if (!key)
+        return { ok: true, skipped: true, note: '대사 검사 건너뜀(검사 키 없음)' };
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-qa-'));
+    const mp3 = path.join(dir, 'a.mp3');
+    try {
+        await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', video, '-vn', '-ac', '1', '-ar', '16000', '-b:a', '48k', mp3]);
+        const b64 = fs.readFileSync(mp3).toString('base64');
+        const r = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${key}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ contents: [{ parts: [{ text: 'This is the audio of a short social video ad. Return JSON only: {"lang": ISO 639-1 code of the spoken language or "none" if no speech, "transcript": verbatim speech, "cutoff": true if the speech is cut off mid-sentence at the end, "garbled": true if the speech is unintelligible or nonsensical for a native listener}.' }, { inline_data: { mime_type: 'audio/mp3', data: b64 } }] }], generationConfig: { responseMimeType: 'application/json' } }), signal: AbortSignal.timeout(90_000) });
+        const j = (await r.json());
+        const txt = j.candidates?.[0]?.content?.parts?.[0]?.text || '{}';
+        const d = JSON.parse(txt.replace(/```json|```/g, ''));
+        const lang = String(d.lang || 'none').slice(0, 2).toLowerCase();
+        const want = o.lang.split('-')[0].toLowerCase();
+        const sim = transcriptSimilarity(o.expected, d.transcript || '');
+        const cutoff = d.cutoff === true || d.cutoff === 'yes' || d.cutoff === 'true';
+        const garbled = d.garbled === true || d.garbled === 'yes' || d.garbled === 'true';
+        const problems = [];
+        if (lang === 'none')
+            problems.push('말소리 없음');
+        else if (lang !== want)
+            problems.push(`언어 불일치(${lang}≠${want})`);
+        if (sim < 0.35)
+            problems.push(`대본과 다름(${Math.round(sim * 100)}%)`);
+        if (garbled)
+            problems.push('발음 불명확');
+        if (cutoff)
+            problems.push('끝에서 끊김');
+        return { ok: !problems.length, note: problems.length ? `대사 검사 실패: ${problems.join(' · ')} — 들린 말 「${(d.transcript || '').slice(0, 60)}」` : `대사 검사 ✓ (${lang} · 대본 일치 ${Math.round(sim * 100)}%)`, data: { lang, transcript: d.transcript, sim, cutoff, garbled } };
+    }
+    catch (e) {
+        return { ok: true, skipped: true, note: `대사 검사 건너뜀(${e instanceof Error ? e.message.slice(0, 80) : e})` };
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+}
+const dataUrl = (file) => { const b = fs.readFileSync(file); return `data:${sniffMime(b)};base64,${b.toString('base64')}`; };
+/** 제품 일치 — 참고 사진 vs 프레임 2장(1초·중간) */
+export async function checkProductMatch(video, refImage) {
+    const cfg = imageConfig();
+    if (!cfg || cfg.provider !== 'bizrouter')
+        return { ok: true, skipped: true, note: '제품 검사 건너뜀(키 없음)' };
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-qa-'));
+    try {
+        const p = await probe(video);
+        const frames = [];
+        for (const t of [1, Math.max(1.5, p.durationSec / 2)]) {
+            const f = path.join(dir, `f${frames.length}.jpg`);
+            await execFileP('ffmpeg', ['-y', '-v', 'error', '-ss', t.toFixed(2), '-i', video, '-frames:v', '1', '-vf', 'scale=480:-1', '-q:v', '4', f]);
+            frames.push(f);
+        }
+        const res = await fetch(`${cfg.base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'bizrouter/qwen-3.8-flash', max_tokens: 200, messages: [{ role: 'user', content: [{ type: 'text', text: 'Image 1 is the advertiser\'s real product photo (reference). Images 2-3 are frames from a generated ad video. Is the product shown in the frames the SAME product as the reference — same overall shape, packaging type, and dominant colors (label text may differ slightly)? Answer JSON only: {"same": true|false, "confidence": 0-1, "reason": "<10 words"}' }, { type: 'image_url', image_url: { url: dataUrl(refImage) } }, ...frames.map((f) => ({ type: 'image_url', image_url: { url: dataUrl(f) } }))] }] }), signal: AbortSignal.timeout(90_000) });
+        const j = (await res.json());
+        const txt = j.choices?.[0]?.message?.content || '{}';
+        const m = /\{[\s\S]*\}/.exec(txt);
+        const d = JSON.parse(m ? m[0] : '{}');
+        const ok = d.same === true && (d.confidence ?? 1) >= 0.5;
+        return { ok, note: ok ? `제품 일치 ✓ (${Math.round((d.confidence ?? 1) * 100)}%)` : `제품 불일치: ${d.reason || '참고 사진과 다른 제품'}`, data: d };
+    }
+    catch (e) {
+        return { ok: true, skipped: true, note: `제품 검사 건너뜀(${e instanceof Error ? e.message.slice(0, 80) : e})` };
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+}
+/** 프레임 위생 — 길이·크기·검은 화면 비율 */
+export async function checkFrames(video, minSec = 2) {
+    try {
+        const p = await probe(video);
+        if (p.durationSec < minSec || !p.w || !p.h)
+            return { ok: false, note: `영상 이상(길이 ${p.durationSec.toFixed(1)}초 · ${p.w}×${p.h})` };
+        const { stderr } = await execFileP('ffmpeg', ['-v', 'info', '-i', video, '-vf', 'blackdetect=d=0.5:pix_th=0.10', '-an', '-f', 'null', '-'], { maxBuffer: 4 << 20 });
+        const black = [...String(stderr).matchAll(/black_duration:([\d.]+)/g)].reduce((n, m) => n + Number(m[1]), 0);
+        if (black > p.durationSec * 0.4)
+            return { ok: false, note: `검은 화면 ${black.toFixed(1)}초` };
+        return { ok: true, note: '프레임 ✓' };
+    }
+    catch (e) {
+        return { ok: true, skipped: true, note: `프레임 검사 건너뜀(${e instanceof Error ? e.message.slice(0, 60) : e})` };
+    }
+}
+/** 사진에 실존 인물(얼굴)이 있나 — 사이트에서 자동으로 가져온 이미지는 연예인·모델 사진일 수 있어 참고 이미지로 쓰면 초상권 위험(2026-09-16 실측: 뷰티 사이트 대표 이미지가 아이돌) → 사람 없는 제품 사진만 통과 */
+export async function containsPerson(image) {
+    const cfg = imageConfig();
+    if (!cfg || cfg.provider !== 'bizrouter')
+        return null;
+    try {
+        const res = await fetch(`${cfg.base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'bizrouter/qwen-3.8-flash', max_tokens: 20, messages: [{ role: 'user', content: [{ type: 'text', text: 'Does this image contain a real human person or face (photo or realistic render)? Answer exactly "yes" or "no".' }, { type: 'image_url', image_url: { url: dataUrl(image) } }] }] }), signal: AbortSignal.timeout(60_000) });
+        const j = (await res.json());
+        return /yes/i.test(j.choices?.[0]?.message?.content || '');
+    }
+    catch {
+        return null;
+    }
+}
+/** 자동 수집 이미지 중 사람 없는 것만(판정 불가면 제외 — 보수적) */
+export async function filterProductRefs(files, log) {
+    const out = [];
+    for (const f of files) {
+        const p = await containsPerson(f);
+        if (p === false)
+            out.push(f);
+        else
+            log?.(`  사이트 이미지 ${f.split('/').pop()} 은 사람이 있어 참고에서 제외(초상권)`);
+    }
+    return out;
+}

package/dist/core/creatives/render.js

@@ -120,9 +120,13 @@ export function tree(size, concept, brief, bg, logo, ctaText) {
     const sub = dark ? 'rgba(255,255,255,.82)' : 'rgba(11,21,38,.72)';
     const bgStyle = bg ? {} : { backgroundImage: dark ? `linear-gradient(135deg, ${brief.palette.dark} 0%, ${hexA(primary, 0.55)} 100%)` : `linear-gradient(135deg, ${brief.palette.light} 0%, ${hexA(primary, 0.18)} 100%)` };
     // 크기별 글자 크기
-    const headFs = short ? Math.round(hh * 0.34) : narrow ? Math.round(w * 0.14) : banner ? Math.round(base * 0.12) : Math.round(base * (hh > w ? 0.085 : 0.078));
-    const bodyFs = short ? 0 : narrow ? Math.round(w * 0.085) : banner ? Math.round(base * 0.062) : Math.round(base * 0.034);
-    const ctaFs = short ? Math.round(hh * 0.28) : narrow ? Math.round(w * 0.09) : banner ? Math.round(base * 0.06) : Math.round(base * 0.028);
+    // 글자 크기 — 메타 포스터(피드·스토리)는 폰 화면에서 읽히게 크게(짧은 변의 11~12% · 메타는 텍스트 20% 규칙이 없음 · 2021 폐지)
+    //   구글 디스플레이 이미지는 반대로 글자를 적게(구글이 헤드라인·설명을 따로 얹고, 이미지 텍스트 20% 초과는 비승인 위험) → 헤드라인만 작게
+    const googleLight = size.medium === 'google' && !banner;
+    // 구글 이미지(1200×628·1200×1200)는 텍스트 20% 안에서 헤드라인 8.5% + 본문 한 줄 3.6% — 너무 비면 썰렁(사장님 검수) · 메타보다 한 단계 작게
+    const headFs = short ? Math.round(hh * 0.34) : narrow ? Math.round(w * 0.14) : banner ? Math.round(base * 0.12) : googleLight ? Math.round(base * 0.085) : Math.round(base * (hh > w ? 0.12 : 0.105));
+    const bodyFs = short ? 0 : narrow ? Math.round(w * 0.085) : banner ? Math.round(base * 0.062) : googleLight ? Math.round(base * 0.036) : Math.round(base * 0.046);
+    const ctaFs = short ? Math.round(hh * 0.28) : narrow ? Math.round(w * 0.09) : banner ? Math.round(base * 0.06) : googleLight ? Math.round(base * 0.036) : Math.round(base * 0.04);
     const children = [];
     if (bg)
         children.push(h('img', { position: 'absolute', top: 0, left: 0, width: w, height: hh, objectFit: 'cover', filter: dark ? 'brightness(.66)' : 'brightness(1.02)' }, undefined, { src: bg, width: w, height: hh }));
@@ -144,7 +148,7 @@ export function tree(size, concept, brief, bg, logo, ctaText) {
             h('div', { display: 'flex', justifyContent: 'space-between', alignItems: 'center' }, [brandRow, domain && !banner ? h('div', { fontSize: Math.round(headFs * 0.3), fontWeight: 500, color: sub }, domain) : h('div', {}, '')]),
             h('div', { display: 'flex', flexDirection: 'column', gap: Math.round(pad * (banner ? 0.35 : 0.5)), maxWidth: isWide ? Math.round(w * 0.72) : w - pad * 2 }, [
                 h('div', { fontSize: headFs, fontWeight: 800, color: fg, lineHeight: 1.12, letterSpacing: -1.5, wordBreak: 'keep-all' }, head),
-                banner && bodyFs < 14 ? h('div', {}, '') : h('div', { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.45, wordBreak: 'keep-all' }, banner ? body.slice(0, 70) : body),
+                (banner && bodyFs < 14) || bodyFs === 0 ? h('div', {}, '') : h('div', { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.45, wordBreak: 'keep-all' }, banner ? body.slice(0, 70) : googleLight ? body.slice(0, 48) : body),
                 h('div', { display: 'flex', marginTop: Math.round(pad * 0.3) }, [ctaPill]),
             ]),
             banner ? h('div', {}, '') : h('div', { display: 'flex', justifyContent: 'space-between', fontSize: Math.round(headFs * 0.28), fontWeight: 500, color: sub }, [h('div', {}, brief.company), h('div', {}, domain)]),

package/dist/core/creatives/storyboard.js

@@ -122,10 +122,27 @@ export async function translateCopy(brief, concept, boards, langs) {
         system: `너는 광고 현지화 카피라이터다. 아래 문구·자막·훅·대사를 각 언어로 옮긴다. 직역이 아니라 그 시장 광고에서 자연스러운 표현으로, 뜻·사실·숫자는 그대로. 헤드라인 ≤ ${GOOGLE_LIMITS.headline}자(한글·전각 2자) · 설명 ≤ ${GOOGLE_LIMITS.description}자 · 자막 각 18자(영문 32자) 이내 · 훅 6단어 이내 · 대사(voice·speech)는 말하면 4~5초 안에 끝나는 짧은 한 문장(영어 ≤ 12단어 · 일본어 ≤ 22자 · 그 언어 원어민이 셀카에서 실제로 쓰는 구어체). 브랜드명(${brief.company})은 번역하지 않는다. 출력 JSON {"translations":{"<lang>":{headlines[],bodies[],descriptions[],boards:[{id,hook,captions[],voice,speech}]}}}`,
         user: JSON.stringify({ sourceLanguage: brief.language, targets: targets.map((t) => `${t} (${langName(t)})`), headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions, boards: boards.map((b) => ({ id: b.id, hook: b.hook, captions: b.captions, voice: b.voice, speech: b.clips.find((c) => c.speech)?.speech })) }),
     });
+    // 키 정규화 — 모델이 "ja (Japanese)"·"Japanese"·"JA" 로 돌려주기도 함
+    const norm = (k) => k.trim().toLowerCase().split(/[\s(]/)[0];
+    const byKey = {};
+    for (const [k, v] of Object.entries(r.translations)) {
+        byKey[norm(k)] = v;
+        const nm = Object.entries(LANG_NAME).find(([, name]) => name.toLowerCase() === k.trim().toLowerCase());
+        if (nm)
+            byKey[nm[0].toLowerCase()] = v;
+    }
     for (const l of targets) {
-        const t = r.translations[l] || r.translations[l.split('-')[0]];
-        if (!t)
-            continue;
+        let t = byKey[l.toLowerCase()] || byKey[l.split('-')[0].toLowerCase()];
+        if (!t) {
+            // 한 언어만 다시(누락 보정) · 그래도 없으면 원문으로 채워 소재 생성은 막지 않는다
+            try {
+                const one = await completeJson({ schema: z.object({ headlines: z.array(z.string()), bodies: z.array(z.string()), descriptions: z.array(z.string()), boards: z.array(z.object({ id: z.string(), hook: z.string(), captions: z.array(z.string()), voice: z.string().optional().nullable(), speech: z.string().optional().nullable() })).optional() }), maxTokens: 3000, timeoutMs: 120_000, system: `광고 문구를 ${langName(l)}(${l}) 로 자연스럽게 옮긴다. 뜻·사실·숫자 유지 · 브랜드명 유지 · 헤드라인 ≤ ${GOOGLE_LIMITS.headline}자 · 자막 각 18자(영문 32자) · 대사는 4~5초 한 문장. 출력 JSON {headlines[],bodies[],descriptions[],boards:[{id,hook,captions[],voice,speech}]}`, user: JSON.stringify({ headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions, boards: boards.map((b) => ({ id: b.id, hook: b.hook, captions: b.captions, voice: b.voice, speech: b.clips.find((c) => c.speech)?.speech })) }) });
+                t = one;
+            }
+            catch {
+                t = { headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions, boards: [] };
+            }
+        }
         out[l] = { headlines: t.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), bodies: t.bodies.map((b) => b.trim()).filter(Boolean), descriptions: t.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean) };
         for (const b of boards) {
             const tb = t.boards?.find((x) => x.id === b.id);

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

@@ -0,0 +1,14 @@
+export type TtsResult = {
+    file: string;
+    durationSec: number;
+    costKrw: number;
+};
+export declare function ttsAvailable(): boolean;
+/** 한 문장 내레이션 mp3 — 톤은 광고 UGC(캐주얼·자연스럽게). 실패는 예외. 원가는 응답에 없어 추정(≈₩15/문장). */
+export declare function synthesizeSpeech(o: {
+    text: string;
+    lang: string;
+    file: string;
+    tone?: 'calm' | 'lively' | 'bold';
+    persona?: string;
+}): Promise<TtsResult>;

package/dist/core/creatives/tts.js

@@ -0,0 +1,21 @@
+// 내레이션 TTS — BizRouter `/v1/audio/speech`(openai/gpt-4o-mini-tts · 한국어 자연도 실측 10/10). 영어가 아닌 시장에서 「말하는 포맷」의 음성은 Veo 발화 대신 TTS 를 얹는다(Veo 한국어 발화는 엉뚱한 대사 · 2026-09-16 사장님 검수).
+import fs from 'node:fs';
+import { imageConfig } from './images.js';
+import { probe } from './videofx.js';
+const VOICE = { ko: 'nova', ja: 'shimmer', en: 'nova', zh: 'nova', default: 'alloy' };
+export function ttsAvailable() { const c = imageConfig(); return !!c && c.provider === 'bizrouter'; }
+/** 한 문장 내레이션 mp3 — 톤은 광고 UGC(캐주얼·자연스럽게). 실패는 예외. 원가는 응답에 없어 추정(≈₩15/문장). */
+export async function synthesizeSpeech(o) {
+    const cfg = imageConfig();
+    if (!cfg || cfg.provider !== 'bizrouter')
+        throw Object.assign(new Error('TTS 키(BizRouter)가 없어요'), { fatal: true });
+    const lang = o.lang.split('-')[0];
+    const style = o.tone === 'calm' ? 'warm, calm, trustworthy' : o.tone === 'bold' ? 'energetic, confident, punchy' : 'casual, upbeat, friendly';
+    const instructions = `Speak in natural ${lang === 'ko' ? 'Korean' : lang === 'ja' ? 'Japanese' : lang === 'zh' ? 'Chinese' : 'the given language'} like a real person talking to their phone camera in a short social video ad: ${style}, conversational pace, not read from a script.${o.persona ? ` Speaker: ${o.persona}.` : ''}`;
+    const res = await fetch(`${cfg.base}/v1/audio/speech`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'openai/gpt-4o-mini-tts', input: o.text, voice: VOICE[lang] || VOICE.default, instructions, response_format: 'mp3' }), signal: AbortSignal.timeout(60_000) });
+    if (!res.ok)
+        throw new Error(`TTS ${res.status} ${(await res.text()).slice(0, 160)}`);
+    fs.writeFileSync(o.file, Buffer.from(await res.arrayBuffer()));
+    const p = await probe(o.file).catch(() => ({ durationSec: 0 }));
+    return { file: o.file, durationSec: p.durationSec, costKrw: 15 };
+}

package/dist/core/creatives/video.js

@@ -34,7 +34,8 @@ async function mockVideo(i) {
     let n = 0;
     for (const ch of i.prompt)
         n = (n * 31 + ch.charCodeAt(0)) >>> 0;
-    const color = `0x${(n & 0xffffff).toString(16).padStart(6, '0')}`;
+    // 모의 색은 어둡지 않게(QA 검은 화면 검사에 걸리지 않도록) — 각 채널 96~255
+    const color = `0x${[16, 8, 0].map((sh) => (96 + ((n >> sh) & 0xff) % 160).toString(16).padStart(2, '0')).join('')}`;
     const inputs = i.firstFrame && fs.existsSync(i.firstFrame)
         ? ['-loop', '1', '-t', String(i.durationSec), '-i', i.firstFrame, '-f', 'lavfi', '-t', String(i.durationSec), '-i', 'anullsrc=r=44100:cl=stereo', '-vf', `scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h},format=yuv420p`]
         : ['-f', 'lavfi', '-t', String(i.durationSec), '-i', `color=c=${color}:s=${w}x${h}:r=24`, '-f', 'lavfi', '-t', String(i.durationSec), '-i', 'anullsrc=r=44100:cl=stereo', '-vf', 'format=yuv420p'];

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

@@ -64,3 +64,13 @@ export declare function kenBurnsClip(image: string, output: string, o: {
 export declare function pickHookBand(video: string, atSec?: number): Promise<'top' | 'middle' | 'lower'>;
 /** 마지막 tailSec 초의 평균 음량(dBFS) — 대사가 끝까지 이어져 「뚝」 끊기는지 판정(무음·음악만이면 낮음). 실패 시 -99. */
 export declare function tailLoudnessDb(file: string, tailSec?: number): Promise<number>;
+/** 내레이션 얹기 — 원본 소리는 낮추고(duck) 0.4초 뒤부터 TTS · 원본이 무음이면 TTS 만 */
+export declare function mixVoiceover(video: string, voice: string, output: string, o?: {
+    duck?: number;
+    startSec?: number;
+}): Promise<void>;
+/** 참고(제품) 사진을 영상 크기 캔버스에 앉힌 첫 프레임 — 배경 PNG(브랜드 그래디언트) 위에 사진을 82% 폭으로 · 실제 제품이 그대로 움직이게 */
+export declare function refCanvas(ref: string, bgPng: string, output: string, dims: {
+    w: number;
+    h: number;
+}): Promise<string>;

package/dist/core/creatives/videofx.js

@@ -176,3 +176,17 @@ export async function tailLoudnessDb(file, tailSec = 0.7) {
         return -99;
     }
 }
+/** 내레이션 얹기 — 원본 소리는 낮추고(duck) 0.4초 뒤부터 TTS · 원본이 무음이면 TTS 만 */
+export async function mixVoiceover(video, voice, output, o = {}) {
+    const p = await probe(video);
+    const duck = o.duck ?? 0.18;
+    const st = Math.round((o.startSec ?? 0.4) * 1000);
+    const fc = p.hasAudio ? `[0:a]volume=${duck}[bg];[1:a]adelay=${st}|${st},volume=1.0[vo];[bg][vo]amix=inputs=2:duration=first:dropout_transition=0,alimiter=limit=0.95[a]` : `[1:a]adelay=${st}|${st},apad,atrim=0:${p.durationSec.toFixed(2)}[a]`;
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', video, '-i', voice, '-filter_complex', fc, '-map', '0:v', '-map', '[a]', '-c:v', 'copy', '-c:a', 'aac', '-ar', '48000', '-ac', '2', '-shortest', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+}
+/** 참고(제품) 사진을 영상 크기 캔버스에 앉힌 첫 프레임 — 배경 PNG(브랜드 그래디언트) 위에 사진을 82% 폭으로 · 실제 제품이 그대로 움직이게 */
+export async function refCanvas(ref, bgPng, output, dims) {
+    const w = Math.round(dims.w * 0.82);
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', bgPng, '-i', ref, '-filter_complex', `[1:v]scale=${w}:-1:force_original_aspect_ratio=decrease,scale='min(iw,${w})':'min(ih,${Math.round(dims.h * 0.7)})':force_original_aspect_ratio=decrease[p];[0:v]scale=${dims.w}:${dims.h}[b];[b][p]overlay=(W-w)/2:(H-h)/2,format=rgb24`, '-frames:v', '1', output]);
+    return output;
+}

package/dist/core/ops.js

@@ -8,6 +8,7 @@ import { generateBackgrounds, userBackgrounds } from './creatives/images.js';
 import { chargeFor, resolveCreativePlan } from './creatives/media.js';
 import { produceConceptVideos } from './creatives/factory.js';
 import { downloadSiteImages, screenshotSite } from './creatives/siteshots.js';
+import { filterProductRefs } from './creatives/qa.js';
 import { renderConcept, renderLogo } from './creatives/render.js';
 import { SIZES } from './creatives/specs.js';
 import { aiAvailable, completeJson } from './llm.js';
@@ -61,7 +62,7 @@ export async function opCreatives(p, o) {
         spec.video = { ...(spec.video || {}), count: 1 };
     if (o.videoSeconds)
         spec.video = { ...(spec.video || {}), durationSec: (o.videoSeconds <= 8 ? 8 : o.videoSeconds <= 15 ? 15 : 30) };
-    const cplan = resolveCreativePlan(spec, { monthlyKrw: p.budget.monthlyKrw, media: connectedMedia(), industry: p.brief.industry, genres: p.brief.visualGenres, hasScreens: true });
+    const cplan = resolveCreativePlan(spec, { monthlyKrw: p.budget.monthlyKrw, media: connectedMedia(), industry: p.brief.industry, genres: p.brief.visualGenres, hasScreens: true, langs: [...new Set(p.budget.markets.map((m) => m.language))] });
     p.creative = spec;
     const count = o.count || cplan.concepts;
     const dir = creativesDir(p.slug);
@@ -91,8 +92,8 @@ export async function opCreatives(p, o) {
     let siteImages = [];
     if (cplan.videos.perConcept.length) {
         siteShot = await screenshotSite(p.url, path.join(dir, 'site_shot.png'));
-        siteImages = await downloadSiteImages(p.brief.siteImages || [], dir, 3);
-        log(`사이트 화면 ${siteShot ? '캡처 ✓' : '캡처 불가(크로미움 없음)'} · 사이트 이미지 ${siteImages.length}장`);
+        siteImages = await filterProductRefs(await downloadSiteImages(p.brief.siteImages || [], dir, 4), log);
+        log(`사이트 화면 ${siteShot ? '캡처 ✓' : '캡처 불가(크로미움 없음)'} · 사이트 이미지(사람 없는 것) ${siteImages.length}장`);
     }
     const langs = [...new Set(p.budget.markets.map((m) => m.language))];
     p.concepts.forEach((c, i) => { void i; });

package/dist/index.d.ts

@@ -14,6 +14,9 @@ export * from './core/creatives/factory.js';
 export * from './core/creatives/playbook.js';
 export * from './core/creatives/storyboard.js';
 export * from './core/creatives/siteshots.js';
+export * from './core/creatives/tts.js';
+export * from './core/creatives/qa.js';
+export * from './core/creatives/models.js';
 export { computePlan, type PlanInput } from './core/plan.js';
 export * from './core/optimize.js';
 export * from './core/report.js';

package/dist/index.js

@@ -15,6 +15,9 @@ export * from './core/creatives/factory.js';
 export * from './core/creatives/playbook.js';
 export * from './core/creatives/storyboard.js';
 export * from './core/creatives/siteshots.js';
+export * from './core/creatives/tts.js';
+export * from './core/creatives/qa.js';
+export * from './core/creatives/models.js';
 export { computePlan } from './core/plan.js';
 export * from './core/optimize.js';
 export * from './core/report.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adyou",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "description": "ADYou — 대행사 없이, 당신이 직접. 사이트 주소 하나로 광고 소재·매체 등록·자동 운영·보고까지: AI 광고 자율주행 CLI + MCP 서버(Meta·Google · 생성은 항상 PAUSED · 승인 뒤 시작)",
   "type": "module",
   "license": "MIT",