adyou 0.3.0 → 0.4.0

package/dist/core/creatives/video.js

@@ -0,0 +1,177 @@
+// 영상 생성 — 두 공급자.
+//   veo:      BizRouter /v1/video/generation (google/veo-3.1[-lite|-fast]) · 4/6/8초 · 16:9|9:16 · 첫 프레임 이미지(image-to-video) · 참조 이미지 ≤3(8초) · 접수 시 cost_krw 확정 · 완료 뒤 30분 안에 다운로드
+//   seedance: BytePlus ModelArk(dreamina-seedance-2-5-260628) · 4~30초 · 480p/720p/1080p · 9:16·16:9·1:1·4:3·3:4 · content[] 에 text + image_url(role first_frame|reference_image) · 원가 = completion_tokens × $10.7/M × FX
+//   두 공급자 모두 네이티브 소리(BGM·효과음·대사)를 낸다 → 「소리 포함」은 generate_audio/프롬프트로.
+//   ADPILOT_MOCK_GEN=1 이면 ffmpeg 로 단색 영상을 만든다(e2e · API 호출 없음).
+import fs from 'node:fs';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { loadConfig } from '../state.js';
+import { imageConfig, isMockGen } from './images.js';
+import { sniffMime } from './render.js';
+import { USD_KRW, VIDEO_DIMS, VIDEO_MODELS } from './media.js';
+const execFileP = promisify(execFile);
+export function videoConfig() {
+    const c = loadConfig().video || {};
+    const img = imageConfig();
+    const veo = img && img.provider === 'bizrouter' ? { base: img.base, key: process.env.ADPILOT_VIDEO_KEY || c.apiKey || img.key } : undefined;
+    const ark = process.env.ARK_API_KEY || c.arkApiKey;
+    const seedance = ark ? { key: ark, base: (process.env.ARK_BASE_URL || 'https://ark.ap-southeast.bytepluses.com/api/v3').replace(/\/+$/, '') } : undefined;
+    return { veo, seedance };
+}
+export function videoAvailable(provider) {
+    if (isMockGen())
+        return true;
+    const c = videoConfig();
+    return provider ? !!c[provider] : !!(c.veo || c.seedance);
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const b64 = (file) => { const buf = fs.readFileSync(file); return { mime_type: sniffMime(buf), data_base64: buf.toString('base64') }; };
+const dataUrl = (file) => { const m = b64(file); return `data:${m.mime_type};base64,${m.data_base64}`; };
+const aspectOf = (r) => r.replace('x', ':');
+async function mockVideo(i) {
+    const { w, h } = VIDEO_DIMS[i.ratio];
+    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')}`;
+    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'];
+    await execFileP('ffmpeg', ['-y', '-v', 'error', ...inputs, '-c:v', 'libx264', '-preset', 'veryfast', '-c:a', 'aac', '-shortest', '-movflags', '+faststart', i.file]);
+    return { file: i.file, costKrw: i.durationSec * 100, provider: 'mock', model: 'mock', durationSec: i.durationSec };
+}
+/** Veo(BizRouter) — 접수 → 폴링 → 다운로드 */
+async function veo(i, cfg) {
+    const log = i.log || (() => { });
+    const H = { authorization: `Bearer ${cfg.key}` };
+    const dur = i.durationSec <= 4 ? 4 : i.durationSec <= 6 ? 6 : 8;
+    const resolution = dur < 8 ? '720p' : i.resolution || '720p';
+    const ratio = i.ratio === '16x9' ? '16x9' : '9x16'; // 1:1·4:5 는 9:16 에서 파생
+    // 🔴 veo-3.1-lite 는 negativePrompt 를 거절(400 · 2026-09-16 실측) → 네거티브는 프롬프트 문장으로만
+    const body = { model: i.model, prompt: i.negative ? `${i.prompt} Avoid: ${i.negative}.` : i.prompt, duration_seconds: dur, resolution, aspect_ratio: aspectOf(ratio) };
+    if (i.firstFrame && fs.existsSync(i.firstFrame))
+        body.image = b64(i.firstFrame);
+    else if (i.refs?.length && dur === 8)
+        body.reference_images = i.refs.filter((f) => fs.existsSync(f)).slice(0, 3).map(b64);
+    const res = await fetch(`${cfg.base}/v1/video/generation`, { method: 'POST', headers: { ...H, 'content-type': 'application/json' }, body: JSON.stringify(body), signal: AbortSignal.timeout(120_000) });
+    const acc = (await res.json().catch(() => ({})));
+    if (!res.ok || !acc.operation_id)
+        throw Object.assign(new Error(`영상 접수 실패 ${res.status} ${typeof acc.error === 'string' ? acc.error : acc.error?.message || JSON.stringify(acc).slice(0, 200)}`), { fatal: res.status < 500 && res.status !== 429 });
+    let costKrw = acc.cost_krw || 0;
+    log(`  영상 접수 ${acc.operation_id} (${i.model} · ${dur}초 · ${resolution} · ${aspectOf(ratio)}${costKrw ? ` · 원가 ₩${Math.round(costKrw)}` : ''})`);
+    const t0 = Date.now();
+    while (Date.now() - t0 < 20 * 60_000) {
+        await sleep(8000);
+        const st = await fetch(`${cfg.base}/v1/video/generation/${acc.operation_id}`, { headers: H, signal: AbortSignal.timeout(60_000) });
+        const s = (await st.json().catch(() => ({})));
+        if (s.cost_krw)
+            costKrw = s.cost_krw;
+        if (s.status === 'failed')
+            throw Object.assign(new Error(`영상 생성 실패: ${s.error || '알 수 없음'}`), { fatal: true, costKrw });
+        if (s.status === 'completed') {
+            const dl = await fetch(`${cfg.base}/v1/video/generation/${acc.operation_id}/download`, { headers: H, signal: AbortSignal.timeout(300_000) });
+            if (!dl.ok)
+                throw new Error(`영상 다운로드 실패 ${dl.status}`);
+            const tmp = i.file + '.tmp';
+            fs.writeFileSync(tmp, Buffer.from(await dl.arrayBuffer()));
+            fs.renameSync(tmp, i.file);
+            return { file: i.file, costKrw, provider: 'veo', model: i.model, durationSec: s.duration_seconds || dur, opId: acc.operation_id };
+        }
+    }
+    throw new Error('영상 생성이 20분 안에 끝나지 않았어요');
+}
+/** Seedance 2.5(ARK) — 태스크 생성 → 폴링 → 다운로드. 원가 = completion_tokens × $10.7/M × FX */
+async function seedance(i, cfg) {
+    const log = i.log || (() => { });
+    const H = { authorization: `Bearer ${cfg.key}`, 'content-type': 'application/json' };
+    const content = [{ type: 'text', text: i.prompt }];
+    const hasFirst = !!(i.firstFrame && fs.existsSync(i.firstFrame));
+    if (hasFirst)
+        content.push({ type: 'image_url', image_url: { url: dataUrl(i.firstFrame) }, role: 'first_frame' });
+    for (const r of (i.refs || []).filter((f) => fs.existsSync(f)).slice(0, 4))
+        content.push({ type: 'image_url', image_url: { url: dataUrl(r) }, role: 'reference_image' });
+    const dur = Math.max(4, Math.min(30, Math.round(i.durationSec)));
+    const body = { model: i.model, content, resolution: i.resolution || '720p', duration: dur, ratio: hasFirst ? 'adaptive' : aspectOf(i.ratio), generate_audio: i.audio !== false, watermark: false };
+    const res = await fetch(`${cfg.base}/contents/generations/tasks`, { method: 'POST', headers: H, body: JSON.stringify(body), signal: AbortSignal.timeout(120_000) });
+    const acc = (await res.json().catch(() => ({})));
+    if (!res.ok || !acc.id)
+        throw Object.assign(new Error(`영상 접수 실패 ${res.status} ${acc.error?.message || JSON.stringify(acc).slice(0, 200)}`), { fatal: res.status < 500 && res.status !== 429 });
+    log(`  영상 접수 ${acc.id} (Seedance 2.5 · ${dur}초 · ${body.resolution} · ${body.ratio})`);
+    const t0 = Date.now();
+    while (Date.now() - t0 < 40 * 60_000) {
+        await sleep(15_000);
+        const st = await fetch(`${cfg.base}/contents/generations/tasks/${acc.id}`, { headers: H, signal: AbortSignal.timeout(60_000) });
+        const s = (await st.json().catch(() => ({})));
+        const tokens = s.usage?.completion_tokens || s.usage?.total_tokens || 0;
+        const costKrw = Math.round((tokens / 1_000_000) * 10.7 * USD_KRW());
+        if (s.status === 'failed' || s.status === 'cancelled')
+            throw Object.assign(new Error(`영상 생성 실패: ${s.error?.message || s.status}`), { fatal: true, costKrw });
+        if (s.status === 'succeeded') {
+            const url = s.content?.video_url;
+            if (!url)
+                throw new Error('영상 주소가 비었어요');
+            const dl = await fetch(url, { signal: AbortSignal.timeout(300_000) });
+            if (!dl.ok)
+                throw new Error(`영상 다운로드 실패 ${dl.status}`);
+            const tmp = i.file + '.tmp';
+            fs.writeFileSync(tmp, Buffer.from(await dl.arrayBuffer()));
+            fs.renameSync(tmp, i.file);
+            return { file: i.file, costKrw, provider: 'seedance', model: i.model, durationSec: dur, opId: acc.id };
+        }
+    }
+    throw new Error('영상 생성이 40분 안에 끝나지 않았어요');
+}
+/** 영상 한 편 — 모델의 공급자로 라우팅. 실패는 예외(fatal 이면 재시도 없이 · costKrw 가 붙어 오면 그만큼은 원가 발생). */
+export async function generateVideo(i) {
+    if (isMockGen())
+        return mockVideo(i);
+    const spec = VIDEO_MODELS[i.model];
+    const provider = spec?.provider || (/veo/.test(i.model) ? 'veo' : 'seedance');
+    const cfg = videoConfig();
+    let lastErr;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            if (provider === 'veo') {
+                if (!cfg.veo)
+                    throw Object.assign(new Error('영상 생성 키(BizRouter)가 없어요'), { fatal: true });
+                return await veo(i, cfg.veo);
+            }
+            if (!cfg.seedance) {
+                if (cfg.veo) {
+                    i.log?.('  Seedance 키가 없어 Veo 로 대신 만들어요(최대 8초)');
+                    return await veo({ ...i, model: 'google/veo-3.1-fast', durationSec: Math.min(8, i.durationSec) }, cfg.veo);
+                }
+                throw Object.assign(new Error('영상 생성 키(ARK)가 없어요'), { fatal: true });
+            }
+            // 🔴 Seedance 「출력 오디오 저작권 의심(OutputAudioSensitiveContentDetected)」(2026-09-16 실측 · 7분 뒤 실패 · 과금 0) → 소리 지시를 바꿔 1회 → 그래도면 무음으로 1회
+            try {
+                return await seedance(i, cfg.seedance);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                if (!/audio may be related to copyright|OutputAudioSensitive/i.test(msg))
+                    throw e;
+                i.log?.('  소리 정책에 걸려(저작권 의심 음악) 소리 지시를 바꿔 다시 만들어요');
+                try {
+                    return await seedance({ ...i, prompt: `${i.prompt} Audio: only original, generic, royalty-free instrumental ambience and light sound effects — no lyrics, no vocals, no recognizable or famous melodies.` }, cfg.seedance);
+                }
+                catch (e2) {
+                    const m2 = e2 instanceof Error ? e2.message : String(e2);
+                    if (!/audio may be related to copyright|OutputAudioSensitive/i.test(m2))
+                        throw e2;
+                    i.log?.('  다시 걸려 이번엔 소리 없이 만들어요');
+                    return await seedance({ ...i, audio: false, prompt: `${i.prompt} Silent video, no audio.` }, cfg.seedance);
+                }
+            }
+        }
+        catch (e) {
+            lastErr = e;
+            if (e.fatal)
+                throw e;
+            i.log?.(`  영상 생성 재시도 (${e instanceof Error ? e.message.slice(0, 120) : e})`);
+            await sleep(5000);
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}

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

@@ -0,0 +1,28 @@
+import { type VideoRatio } from './media.js';
+export declare function hasFfmpeg(): Promise<boolean>;
+export type Probe = {
+    w: number;
+    h: number;
+    durationSec: number;
+    hasAudio: boolean;
+};
+export declare function probe(file: string): Promise<Probe>;
+export declare const ratioOf: (w: number, h: number) => VideoRatio;
+/** Pretendard 굵은 글꼴 경로(render.ts 의 loadFonts 가 ~/.adpilot/fonts 에 내려받는다) */
+export declare function fontFile(): string | null;
+/** 자막·CTA 오버레이 — 투명 PNG(영상과 같은 크기)를 구간별로 얹는다(overlay 필터 · 폰트 빌드 의존 없음). overlays 가 비면 복사만. */
+export declare function burnCaptions(input: string, output: string, o: {
+    overlays: {
+        png: string;
+        start: number;
+        end: number;
+    }[];
+}): Promise<void>;
+/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 소리는 유지(엔드카드 구간은 무음). */
+export declare function appendEndCard(input: string, cardPng: string, output: string, seconds?: number): Promise<void>;
+/** 비율 파생 — 중앙 크롭 후 표준 크기로 스케일(9:16 → 4:5 · 1:1, 16:9 → 1:1) */
+export declare function deriveRatio(input: string, output: string, ratio: VideoRatio): Promise<void>;
+/** 표준 크기로 정규화(올린 영상 · 코덱 통일 · 최대 60초) */
+export declare function normalize(input: string, output: string, ratio: VideoRatio, maxSec?: number): Promise<Probe>;
+/** 대표 프레임(썸네일) — 1초 지점 JPEG */
+export declare function thumbnail(input: string, output: string, atSec?: number): Promise<void>;

package/dist/core/creatives/videofx.js

@@ -0,0 +1,86 @@
+// 영상 후처리(ffmpeg) — 자막 번인(헤드라인·CTA · Pretendard) · 엔드카드(로고·CTA 정지화면 2초) 이어붙이기 · 비율 파생(9:16 → 4:5·1:1 중앙 크롭) · 프로브.
+// ffmpeg 가 없으면 원본 영상을 그대로 쓴다(호출자가 hasFfmpeg 로 분기).
+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 { HOME } from '../state.js';
+import { VIDEO_DIMS } from './media.js';
+const execFileP = promisify(execFile);
+let ffmpegOk = null;
+export async function hasFfmpeg() {
+    if (ffmpegOk !== null)
+        return ffmpegOk;
+    try {
+        await execFileP('ffmpeg', ['-version']);
+        await execFileP('ffprobe', ['-version']);
+        ffmpegOk = true;
+    }
+    catch {
+        ffmpegOk = false;
+    }
+    return ffmpegOk;
+}
+export async function probe(file) {
+    const { stdout } = await execFileP('ffprobe', ['-v', 'error', '-print_format', 'json', '-show_streams', '-show_format', file], { maxBuffer: 8 << 20 });
+    const j = JSON.parse(stdout);
+    const v = j.streams.find((s) => s.codec_type === 'video');
+    const a = j.streams.find((s) => s.codec_type === 'audio');
+    return { w: v?.width || 0, h: v?.height || 0, durationSec: Number(j.format.duration || v?.duration || 0), hasAudio: !!a };
+}
+export const ratioOf = (w, h) => { const r = w / h; if (r < 0.65)
+    return '9x16'; if (r < 0.9)
+    return '4x5'; if (r < 1.3)
+    return '1x1'; return '16x9'; };
+/** Pretendard 굵은 글꼴 경로(render.ts 의 loadFonts 가 ~/.adpilot/fonts 에 내려받는다) */
+export function fontFile() {
+    const cands = [path.join(HOME, 'fonts', 'Pretendard-Bold.otf'), path.join(HOME, 'fonts', 'Pretendard-ExtraBold.otf'), path.join(os.homedir(), 'Library/Fonts/Pretendard-Bold.otf'), '/usr/share/fonts/Pretendard-Bold.otf'];
+    return cands.find((f) => fs.existsSync(f)) || null;
+}
+/** 자막·CTA 오버레이 — 투명 PNG(영상과 같은 크기)를 구간별로 얹는다(overlay 필터 · 폰트 빌드 의존 없음). overlays 가 비면 복사만. */
+export async function burnCaptions(input, output, o) {
+    const ov = o.overlays.filter((x) => fs.existsSync(x.png));
+    if (!ov.length) {
+        fs.copyFileSync(input, output);
+        return;
+    }
+    const p = await probe(input);
+    const inputs = ['-i', input];
+    for (const x of ov)
+        inputs.push('-i', x.png);
+    // 각 PNG 를 영상 크기로 맞춘 뒤 구간(enable) 동안만 얹는다 — 체인: [0:v] → [v0] → … → [v]
+    const fc = ov.map((x, i) => { const src = i === 0 ? '[0:v]' : `[v${i - 1}]`; const out = i === ov.length - 1 ? '[v]' : `[v${i}]`; return `[${i + 1}:v]scale=${p.w}:${p.h}[o${i}];${src}[o${i}]overlay=0:0:enable='between(t,${x.start.toFixed(2)},${x.end.toFixed(2)})'${out}`; }).join(';');
+    const args = ['-y', '-v', 'error', ...inputs, '-filter_complex', fc, '-map', '[v]', ...(p.hasAudio ? ['-map', '0:a', '-c:a', 'copy'] : []), '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-pix_fmt', 'yuv420p', '-movflags', '+faststart', output];
+    await execFileP('ffmpeg', args, { maxBuffer: 8 << 20 });
+}
+/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 소리는 유지(엔드카드 구간은 무음). */
+export async function appendEndCard(input, cardPng, output, seconds = 2) {
+    const p = await probe(input);
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-end-'));
+    const card = path.join(dir, 'card.mp4');
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-loop', '1', '-t', String(seconds), '-i', cardPng, '-f', 'lavfi', '-t', String(seconds), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', `scale=${p.w}:${p.h}:force_original_aspect_ratio=increase,crop=${p.w}:${p.h},format=yuv420p,fps=24`, '-c:v', 'libx264', '-preset', 'veryfast', '-c:a', 'aac', '-shortest', card]);
+    const main = path.join(dir, 'main.mp4');
+    // 본편도 같은 코덱·프레임레이트·오디오로 정규화(무음이면 무음 트랙 추가) → concat 필터
+    const args = p.hasAudio
+        ? ['-y', '-v', 'error', '-i', input, '-vf', 'fps=24,format=yuv420p', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-ar', '48000', '-ac', '2', main]
+        : ['-y', '-v', 'error', '-i', input, '-f', 'lavfi', '-t', String(p.durationSec), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', 'fps=24,format=yuv420p', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-shortest', main];
+    await execFileP('ffmpeg', args, { maxBuffer: 8 << 20 });
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', main, '-i', card, '-filter_complex', '[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]', '-map', '[v]', '-map', '[a]', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+/** 비율 파생 — 중앙 크롭 후 표준 크기로 스케일(9:16 → 4:5 · 1:1, 16:9 → 1:1) */
+export async function deriveRatio(input, output, ratio) {
+    const { w, h } = VIDEO_DIMS[ratio];
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', input, '-vf', `scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h},format=yuv420p`, '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'copy', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+}
+/** 표준 크기로 정규화(올린 영상 · 코덱 통일 · 최대 60초) */
+export async function normalize(input, output, ratio, maxSec = 60) {
+    const { w, h } = VIDEO_DIMS[ratio];
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', input, '-t', String(maxSec), '-vf', `scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h},format=yuv420p,fps=24`, '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    return probe(output);
+}
+/** 대표 프레임(썸네일) — 1초 지점 JPEG */
+export async function thumbnail(input, output, atSec = 1) {
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-ss', String(atSec), '-i', input, '-frames:v', '1', '-q:v', '3', output]);
+}

package/dist/core/llm.js

@@ -61,17 +61,24 @@ export function extractJson(text) {
 export async function completeJson(opts) {
     const system = `${opts.system}\n\n출력 규칙: 설명 없이 JSON 하나만 출력한다. 코드펜스를 쓰지 않는다. 문자열 안 줄바꿈은 \\n으로 이스케이프한다.`;
     let user = opts.user;
+    let last = '';
     for (let i = 0; i < 2; i++) {
         const raw = await complete({ ...opts, system, user });
         try {
             const r = opts.schema.safeParse(JSON.parse(extractJson(raw)));
             if (r.success)
                 return r.data;
-            user = `${opts.user}\n\n(직전 답이 형식과 달랐어요: ${r.error.issues.slice(0, 3).map((x) => `${x.path.join('.')}: ${x.message}`).join(' | ')}. 요구한 키와 타입을 정확히 지켜 JSON만 다시 출력해 주세요.)`;
+            last = r.error.issues.slice(0, 3).map((x) => `${x.path.join('.')}: ${x.message}`).join(' | ');
+            if (process.env.ADPILOT_LLM_DEBUG)
+                console.error('[llm] schema issues:', last, '\n', raw.slice(0, 1500));
+            user = `${opts.user}\n\n(직전 답이 형식과 달랐어요: ${last}. 요구한 키와 타입을 정확히 지켜 JSON만 다시 출력해 주세요.)`;
         }
         catch (e) {
+            last = `JSON 파싱 실패: ${e instanceof Error ? e.message.slice(0, 80) : e}`;
+            if (process.env.ADPILOT_LLM_DEBUG)
+                console.error('[llm] parse fail:', raw.slice(0, 1500));
             user = `${opts.user}\n\n(직전 답이 JSON으로 파싱되지 않았어요. JSON만 다시 출력해 주세요.)`;
         }
     }
-    throw new Error('LLM이 요구한 JSON 형식을 두 번 모두 지키지 못했어요.');
+    throw new Error(`LLM이 요구한 JSON 형식을 두 번 모두 지키지 못했어요.${last ? ` (${last})` : ''}`);
 }

package/dist/core/ops.d.ts

@@ -1,5 +1,6 @@
 import { connector } from '../adapters/index.js';
 import type { CheckItem, Medium, MetricRow } from '../adapters/types.js';
+import { type CreativeMode, type CreativeSpec } from './creatives/media.js';
 import { type Proposal } from './optimize.js';
 import { type Goal, type Market, type Project } from './state.js';
 export type Log = (s: string) => void;
@@ -21,6 +22,11 @@ export declare function opCreatives(p: Project, o: {
     images?: string;
     noImages?: boolean;
     force?: boolean;
+    mode?: CreativeMode;
+    video?: boolean;
+    videoSeconds?: number;
+    requirements?: string;
+    spec?: CreativeSpec;
     log?: Log;
 }): Promise<{
     project: Project;

package/dist/core/ops.js

@@ -5,6 +5,8 @@ import { connectedMedia, connector } from '../adapters/index.js';
 import { buildBrief, explainBrief } from './brief.js';
 import { generateConcepts, validateConcepts } from './creatives/copy.js';
 import { generateBackgrounds, userBackgrounds } from './creatives/images.js';
+import { chargeFor, resolveCreativePlan } from './creatives/media.js';
+import { produceConceptVideos } from './creatives/factory.js';
 import { renderConcept, renderLogo } from './creatives/render.js';
 import { SIZES } from './creatives/specs.js';
 import { aiAvailable, completeJson } from './llm.js';
@@ -50,11 +52,22 @@ export async function opCreatives(p, o) {
         throw new Error('브리프가 먼저 필요해요.');
     if (p.brief.specialCategory)
         throw new Error(`「${p.brief.specialCategory}」 특별 광고 카테고리는 접수할 수 없어요.`);
-    const count = o.count || 3;
+    // 소재 설정(형태·출처·영상) — 명시 spec > 플래그 > 프로젝트 저장값. CLI 는 --video 없으면 이미지만(비용 예측 가능).
+    const spec = { ...(p.creative || {}), ...(o.spec || {}), ...(o.mode ? { mode: o.mode } : {}), ...(o.requirements ? { source: 'guided', prompt: o.requirements } : {}) };
+    if (o.video === false || (o.video === undefined && !o.spec?.video && !p.creative?.video && !o.mode))
+        spec.video = { ...(spec.video || {}), count: 0 };
+    if (o.video && !(spec.video?.count))
+        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() });
+    p.creative = spec;
+    const count = o.count || cplan.concepts;
     const dir = creativesDir(p.slug);
+    log(cplan.explain);
     if (o.force || o.feedback || !p.concepts?.length) {
         log(`컨셉 ${count}개·카피 만드는 중…${o.feedback ? ` (수정 요청: ${o.feedback})` : ''}`);
-        p.concepts = await generateConcepts(p.brief, { goal: p.budget.goal, count, feedback: o.feedback, previous: p.concepts });
+        p.concepts = await generateConcepts(p.brief, { goal: p.budget.goal, count, feedback: o.feedback, previous: p.concepts, requirements: spec.prompt, userCopy: spec.copy, video: cplan.videos.perConcept.length > 0 });
         if (o.feedback || o.force)
             for (const f of fs.readdirSync(dir))
                 if (/^(?!bg_).*\.png$/.test(f))
@@ -70,19 +83,28 @@ export async function opCreatives(p, o) {
     const assets = [];
     // 로고 자산(구글 RDA 용 1:1 · 4:1)
     assets.push(...(await renderLogo(dir, p.brief)));
-    for (const c of p.concepts) {
+    let costKrw = 0;
+    const refs = o.images ? fs.readdirSync(o.images).filter((f) => /\.(png|jpe?g|webp)$/i.test(f)).map((f) => path.join(o.images, f)) : [];
+    p.concepts.forEach((c, i) => { void i; });
+    for (const [ci, c] of p.concepts.entries()) {
         let bgs;
-        if (o.images)
+        if (o.images && spec.source !== 'guided')
             bgs = userBackgrounds(o.images, c.key);
-        else if (o.noImages)
+        else if (o.noImages || !cplan.images.enabled)
             bgs = {};
         else {
             log(`배경 이미지 생성 ${c.key}…`);
-            bgs = await generateBackgrounds(dir, c.key, c.imagePrompt, undefined, log);
+            bgs = await generateBackgrounds(dir, c.key, c.imagePrompt, undefined, log, { model: cplan.images.model, refs: spec.source === 'guided' ? refs : undefined, onAsset: (a) => { costKrw += a.costKrw; } });
         }
         log(`합성 ${c.key} × ${SIZES.length}규격…`);
         assets.push(...(await renderConcept(dir, p.brief, c, bgs, { force: o.force || !!o.feedback, log })));
+        if (cplan.videos.perConcept.length && ci < cplan.videos.conceptsWithVideo) {
+            const vids = await produceConceptVideos({ dir, brief: p.brief, concept: c, jobs: cplan.videos.perConcept, backgrounds: bgs, refs, log, onAsset: (a) => { costKrw += a.costKrw; } });
+            assets.push(...vids.filter((v) => v.file));
+        }
     }
+    if (costKrw)
+        log(`소재 생성 원가 ₩${Math.round(costKrw).toLocaleString()} (청구 기준 ₩${chargeFor(costKrw).toLocaleString()})`);
     p.assets = assets;
     p.status = 'creatives';
     fs.writeFileSync(path.join(dir, 'copy.json'), JSON.stringify(p.concepts, null, 2));

package/dist/core/state.d.ts

@@ -24,9 +24,15 @@ export type Config = {
         model?: string;
     };
     image?: {
-        provider?: 'openai';
+        provider?: 'openai' | 'bizrouter';
         apiKey?: string;
         model?: string;
+        baseUrl?: string;
+    };
+    video?: {
+        apiKey?: string;
+        arkApiKey?: string;
+        model?: string;
     };
     /** 원화 기준 환율 — 매체 계정 통화가 KRW가 아닐 때 예산 환산에 쓴다 */
     fx?: Record<string, number>;
@@ -67,7 +73,12 @@ export type Concept = {
     cta: string;
     imagePrompt: string;
     theme: 'dark' | 'light';
+    /** 영상 프롬프트(영어 · 8~30초 광고 한 컷 연출) · 화면 자막 2~3줄 · 대사/내레이션 한 줄(선택) */
+    videoPrompt?: string;
+    videoLines?: string[];
+    videoVoice?: string;
 };
+/** 소재 자산 — 이미지(PNG) 또는 영상(MP4). type 이 없으면 이미지. costKrw 는 생성 원가(원). variant 는 같은 크기의 A/B 변형 구분(기본 ''). */
 export type CreativeAsset = {
     concept: string;
     w: number;
@@ -75,6 +86,12 @@ export type CreativeAsset = {
     ratio: string;
     file: string;
     medium: 'meta' | 'google' | 'both';
+    type?: 'image' | 'video';
+    variant?: string;
+    durationSec?: number;
+    mime?: string;
+    costKrw?: number;
+    origin?: 'ai' | 'upload';
 };
 export type PlanMedium = {
     medium: 'meta' | 'google';
@@ -99,6 +116,7 @@ export type Placement = {
     medium: 'meta' | 'google';
     kind: string;
     concept?: string;
+    format?: 'image' | 'video';
     externalId: string;
     name: string;
     status: string;
@@ -120,6 +138,8 @@ export type Project = {
     brief?: Brief;
     concepts?: Concept[];
     assets?: CreativeAsset[];
+    /** 소재 만들기 설정(형태·출처·영상 옵션) — creatives/media.ts 의 CreativeSpec */
+    creative?: import('./creatives/media.js').CreativeSpec;
     plan?: Plan;
     placements: Placement[];
     tracking?: {

package/dist/index.d.ts

@@ -7,6 +7,10 @@ export { SIZES, BG_RATIOS, wlen, fit, GOOGLE_LIMITS, GOOGLE_CTA, META_CTA, ctaFo
 export * from './core/creatives/copy.js';
 export * from './core/creatives/images.js';
 export * from './core/creatives/render.js';
+export * from './core/creatives/media.js';
+export * from './core/creatives/video.js';
+export * from './core/creatives/videofx.js';
+export * from './core/creatives/factory.js';
 export { computePlan, type PlanInput } from './core/plan.js';
 export * from './core/optimize.js';
 export * from './core/report.js';

package/dist/index.js

@@ -8,6 +8,10 @@ export { SIZES, BG_RATIOS, wlen, fit, GOOGLE_LIMITS, GOOGLE_CTA, META_CTA, ctaFo
 export * from './core/creatives/copy.js';
 export * from './core/creatives/images.js';
 export * from './core/creatives/render.js';
+export * from './core/creatives/media.js';
+export * from './core/creatives/video.js';
+export * from './core/creatives/videofx.js';
+export * from './core/creatives/factory.js';
 export { computePlan } from './core/plan.js';
 export * from './core/optimize.js';
 export * from './core/report.js';

package/dist/mcp.js

@@ -34,9 +34,9 @@ export async function startMcp() {
     catch (e) {
         return err(e);
     } });
-    server.registerTool('adyou_creatives', { description: '컨셉·카피 생성 + 배경 이미지 + 12규격 소재 합성 + 규격 검사. feedback을 주면 그 방향으로 전부 다시 만든다.', inputSchema: { project: z.string().optional(), concepts: z.number().optional(), feedback: z.string().optional(), imagesFolder: z.string().optional(), noImages: z.boolean().optional() } }, async (a) => { try {
+    server.registerTool('adyou_creatives', { description: '컨셉·카피 생성 + 배경 이미지 + 12규격 소재 합성 + 규격 검사. feedback을 주면 그 방향으로 전부 다시 만든다.', inputSchema: { project: z.string().optional(), concepts: z.number().optional(), feedback: z.string().optional(), mode: z.enum(['auto', 'image', 'video', 'text']).optional(), video: z.boolean().optional(), videoSeconds: z.number().optional(), requirements: z.string().optional(), imagesFolder: z.string().optional(), noImages: z.boolean().optional() } }, async (a) => { try {
         const logs = [];
-        const { project, report } = await opCreatives(proj(a.project), { count: a.concepts, feedback: a.feedback, images: a.imagesFolder, noImages: a.noImages, log: (s) => logs.push(s) });
+        const { project, report } = await opCreatives(proj(a.project), { count: a.concepts, feedback: a.feedback, images: a.imagesFolder, noImages: a.noImages, mode: a.mode, video: a.video, videoSeconds: a.videoSeconds, requirements: a.requirements, log: (s) => logs.push(s) });
         return text(`컨셉 ${project.concepts.length} · 소재 ${project.assets.length}장\n${project.concepts.map((c) => `· ${c.name}(${c.key}) — ${c.headlines[0]} / ${c.bodies[0]}`).join('\n')}\n${report.length ? `규격 경고:\n${report.join('\n')}\n` : ''}갤러리: ~/.adpilot/projects/${project.slug}/creatives/index.html`);
     }
     catch (e) {

package/package.json

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