ADO2 Hookit — 8초 숏폼 생성기

+ {eyebrow} +

+ {title} +

+ + ); +}; diff --git a/remotion/src/components/SellingBadge.tsx b/remotion/src/components/SellingBadge.tsx new file mode 100644 index 0000000..ea3e657 --- /dev/null +++ b/remotion/src/components/SellingBadge.tsx @@ -0,0 +1,69 @@ +import React from "react"; +import { + useCurrentFrame, + useVideoConfig, + interpolate, + spring, + AbsoluteFill, +} from "remotion"; +import { serifFont } from "../fonts"; + +// 셀링포인트: 3개 독립 pill 박스를 세로로 쌓고 순차 등장. +// 컬러 지양 → 반투명 다크 pill + 흰색 텍스트. 앞 구간 단독 노출(시선 집중). +export const SellingBadge: React.FC<{ + items: string[]; + fromFrame: number; + toFrame: number; +}> = ({ items, fromFrame, toFrame }) => { + const frame = useCurrentFrame(); + const { fps } = useVideoConfig(); + const STAGGER = 9; // 박스 간 등장 간격(frame) + + return ( + + {items.map((item, i) => { + const start = fromFrame + i * STAGGER; + const enter = spring({ + frame: frame - start, + fps, + config: { damping: 200, mass: 0.5 }, + }); + const rise = interpolate(enter, [0, 1], [22, 0]); + const appear = interpolate( + frame, + [start, start + 8, toFrame - 10, toFrame], + [0, 1, 1, 0], + { extrapolateLeft: "clamp", extrapolateRight: "clamp" }, + ); + return ( +

+ {item} +

+ ); + })} + + ); +}; diff --git a/remotion/src/components/Subtitle.tsx b/remotion/src/components/Subtitle.tsx new file mode 100644 index 0000000..aa09d86 --- /dev/null +++ b/remotion/src/components/Subtitle.tsx @@ -0,0 +1,53 @@ +import React from "react"; +import { + useCurrentFrame, + interpolate, + AbsoluteFill, +} from "remotion"; +import { serifFont } from "../fonts"; + +// 브랜드 자막: 페이드 + 미세 상승 (Profile A 모션 프리셋) +export const Subtitle: React.FC<{ + text: string; + fromFrame: number; + toFrame: number; +}> = ({ text, fromFrame, toFrame }) => { + const frame = useCurrentFrame(); + + const opacity = interpolate( + frame, + [fromFrame, fromFrame + 10, toFrame - 10, toFrame], + [0, 1, 1, 0], + { extrapolateLeft: "clamp", extrapolateRight: "clamp" }, + ); + const rise = interpolate(frame, [fromFrame, fromFrame + 18], [18, 0], { + extrapolateLeft: "clamp", + extrapolateRight: "clamp", + }); + + return ( + +

+ {text} +

+ + ); +}; diff --git a/remotion/src/data/mumum.ts b/remotion/src/data/mumum.ts new file mode 100644 index 0000000..ad44444 --- /dev/null +++ b/remotion/src/data/mumum.ts @@ -0,0 +1,35 @@ +// Default props = the verified 머뭄 PoC #2 layout. +// The Python render bridge overrides these per-job via --props. +import { ShortProps } from "./types"; + +export const defaultProps: ShortProps = { + videoSrc: "mumum_marketing_v1.mp4", + fps: 30, + width: 720, + height: 1280, + durationInFrames: 241, // ≈ 8.04s + + hook: { + eyebrow: "아무도 모르는 군산", + title: "골목 안, 단 한 채의 독채 스테이 머뭄", + fromFrame: 0, + toFrame: 78, + }, + sellingPoint: { + items: ["프라이빗 독채펜션", "넓은 정원", "핵심 관광지 가까이"], + fromFrame: 80, + toFrame: 138, + }, + brandLines: { + lines: ["머무는 시간이", "다르게 흐르는 곳"], + fromFrame: 138, + toFrame: 196, + }, + endCard: { + brand: "Stay, 머뭄", + location: "전북 군산시 절골길 18", + disclosure: "실제 사진 기반, AI 카메라 효과를 적용한 영상입니다.", + fromFrame: 192, + toFrame: 241, + }, +}; diff --git a/remotion/src/data/types.ts b/remotion/src/data/types.ts new file mode 100644 index 0000000..bcc7c26 --- /dev/null +++ b/remotion/src/data/types.ts @@ -0,0 +1,19 @@ +// Props contract — shared by Remotion composition and the Python render bridge. +// Mirrors server/app/schemas.py VideoSpec (+ video config + timings). +export type ShortProps = { + videoSrc: string; // file in public/ (staticFile name) + fps: number; + width: number; + height: number; + durationInFrames: number; + hook: { eyebrow: string; title: string; fromFrame: number; toFrame: number }; + sellingPoint: { items: string[]; fromFrame: number; toFrame: number }; + brandLines: { lines: string[]; fromFrame: number; toFrame: number }; + endCard: { + brand: string; + location: string; + disclosure: string; + fromFrame: number; + toFrame: number; + }; +}; diff --git a/remotion/src/fonts.ts b/remotion/src/fonts.ts new file mode 100644 index 0000000..038d830 --- /dev/null +++ b/remotion/src/fonts.ts @@ -0,0 +1,15 @@ +// 한글 폰트 로딩 (@remotion/google-fonts, korean subset) +// Hook = Black Han Sans (굵고 강렬한 바이럴 헤드라인) +// Body/Brand = Nanum Myeongjo (우아한 명조 — 머뭄의 정적 브랜드 톤) +import { loadFont as loadHook } from "@remotion/google-fonts/BlackHanSans"; +import { loadFont as loadSerif } from "@remotion/google-fonts/NanumMyeongjo"; + +export const hookFont = loadHook("normal", { + weights: ["400"], + subsets: ["korean", "latin"], +}).fontFamily; + +export const serifFont = loadSerif("normal", { + weights: ["400", "700", "800"], + subsets: ["korean", "latin"], +}).fontFamily; diff --git a/remotion/src/index.ts b/remotion/src/index.ts new file mode 100644 index 0000000..f31c790 --- /dev/null +++ b/remotion/src/index.ts @@ -0,0 +1,4 @@ +import { registerRoot } from "remotion"; +import { RemotionRoot } from "./Root"; + +registerRoot(RemotionRoot); diff --git a/remotion/tsconfig.json b/remotion/tsconfig.json new file mode 100644 index 0000000..fea0181 --- /dev/null +++ b/remotion/tsconfig.json @@ -0,0 +1,15 @@ +{ + "compilerOptions": { + "target": "ES2020", + "lib": ["ES2020", "DOM", "DOM.Iterable"], + "module": "ESNext", + "moduleResolution": "Bundler", + "jsx": "react-jsx", + "strict": true, + "esModuleInterop": true, + "skipLibCheck": true, + "forceConsistentCasingInFileNames": true, + "noEmit": true + }, + "include": ["src"] +} diff --git a/server/.env.example b/server/.env.example new file mode 100644 index 0000000..f3eefc4 --- /dev/null +++ b/server/.env.example @@ -0,0 +1,6 @@ +# ADO2 Higgsfield Shorts server +# Claude API (spec_builder) +ANTHROPIC_API_KEY= + +# Higgsfield CLI must be authenticated separately: `higgsfield auth login` +# (the server shells out to the CLI; no key needed here) diff --git a/server/app/__init__.py b/server/app/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/server/app/main.py b/server/app/main.py new file mode 100644 index 0000000..15b6136 --- /dev/null +++ b/server/app/main.py @@ -0,0 +1,115 @@ +"""④ FastAPI orchestration — LLM → Higgsfield → Remotion wrapper. + +POST /api/generate (multipart: photos[] + interview fields) + → build_spec (Claude) → higgsfield.generate → remotion.render → mp4 +GET /api/health +Static: /outputs/ (final videos), / (the web app) +""" +from __future__ import annotations + +import shutil +import uuid +from pathlib import Path + +from fastapi import FastAPI, File, Form, UploadFile, HTTPException +from fastapi.middleware.cors import CORSMiddleware +from fastapi.responses import FileResponse +from fastapi.staticfiles import StaticFiles + +from app.schemas import GenerateRequest, GenerateResult, ScriptResult +from app.pipeline import spec_builder, higgsfield_client, remotion_render + +ENGINE = Path(__file__).resolve().parents[2] # engine/higgsfield_shorts +WEBAPP = ENGINE / "webapp" +OUTPUTS = ENGINE / "server" / "outputs" +UPLOADS = ENGINE / "server" / ".uploads" +OUTPUTS.mkdir(parents=True, exist_ok=True) + +app = FastAPI(title="ADO2 Higgsfield Shorts") +app.add_middleware( + CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"], +) + + +@app.get("/api/health") +def health(): + return {"ok": True} + + +@app.post("/api/captions", response_model=ScriptResult) +def captions(req: GenerateRequest): + """인터뷰 답변 → 인트로·셀링포인트·감성스토리·CTA 4블록 (Claude).""" + try: + return spec_builder.build_script(req) + except Exception as e: + raise HTTPException(502, f"자막 생성 실패: {e}") from e + + +@app.post("/api/generate", response_model=GenerateResult) +async def generate( + photos: list[UploadFile] = File(...), + kind: str = Form(...), + biz_name: str = Form(...), + selling: str = Form(...), + addr: str | None = Form(None), + price: str | None = Form(None), + dry_run: bool = Form(False), +): + if len(photos) < 4: + raise HTTPException(400, "사진 4장 이상이 필요합니다.") + + # 1. Persist uploaded photos + job = uuid.uuid4().hex[:8] + job_dir = UPLOADS / job + job_dir.mkdir(parents=True, exist_ok=True) + photo_paths: list[Path] = [] + for i, up in enumerate(photos): + dest = job_dir / f"{i:02d}_{Path(up.filename or 'img').name}" + with dest.open("wb") as f: + shutil.copyfileobj(up.file, f) + photo_paths.append(dest) + + req = GenerateRequest(kind=kind, biz_name=biz_name, addr=addr, price=price, selling=selling) + + # 2. LLM → spec + try: + spec = spec_builder.build_spec(req) + except Exception as e: # surface as a clean 502, don't swallow + raise HTTPException(502, f"spec 생성 실패: {e}") from e + + # 3. Higgsfield → base video + try: + base_video, credits = higgsfield_client.generate( + spec.higgsfield_prompt, photo_paths, dry_run=dry_run + ) + except Exception as e: + raise HTTPException(502, f"Higgsfield 생성 실패: {e}") from e + + # 4. Remotion → final with overlays + try: + final = remotion_render.render(spec, base_video) + except Exception as e: + raise HTTPException(502, f"Remotion 합성 실패: {e}") from e + + served = OUTPUTS / f"{job}.mp4" + shutil.copy(final, served) + + return GenerateResult( + video_url=f"/outputs/{job}.mp4", + caption=spec.caption, + profile=spec.profile, + cost_credits=credits, + job_id=job, + ) + + +# Static mounts (after API routes) +app.mount("/outputs", StaticFiles(directory=str(OUTPUTS)), name="outputs") + + +@app.get("/") +def index(): + return FileResponse(str(WEBAPP / "index.html")) + + +app.mount("/", StaticFiles(directory=str(WEBAPP)), name="webapp") diff --git a/server/app/pipeline/__init__.py b/server/app/pipeline/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/server/app/pipeline/higgsfield_client.py b/server/app/pipeline/higgsfield_client.py new file mode 100644 index 0000000..b8da8f9 --- /dev/null +++ b/server/app/pipeline/higgsfield_client.py @@ -0,0 +1,70 @@ +"""② Higgsfield step — photos + prompt → completed 8s base video. + +Thin wrapper around the verified CLI flow: + higgsfield generate cost/create marketing_studio_video --mode tv_spot ... +dry_run=True returns a bundled demo clip and spends no credits. +""" +from __future__ import annotations + +import json +import re +import subprocess +import urllib.request +import uuid +from pathlib import Path + +ENGINE = Path(__file__).resolve().parents[3] # engine/higgsfield_shorts +DEMO_VIDEO = ENGINE / "webapp" / "demo" / "mumum.mp4" +TMP = ENGINE / "server" / ".tmp" + +MODEL = "marketing_studio_video" +_URL_RE = re.compile(r'"result_url"\s*:\s*"([^"]+)"') +_CREDITS_RE = re.compile(r'"credits(?:_exact)?"\s*:\s*([0-9.]+)') + + +def _base_args(prompt: str, image_paths: list[Path], duration: int) -> list[str]: + args = ["--prompt", prompt] + for p in image_paths: + args += ["--image", str(p)] + args += ["--mode", "tv_spot", "--duration", str(duration), + "--generate_audio", "true", "--aspect_ratio", "9:16"] + return args + + +def cost(prompt: str, image_paths: list[Path], duration: int = 8) -> float: + out = subprocess.run( + ["higgsfield", "generate", "cost", MODEL, *_base_args(prompt, image_paths, duration), "--json"], + capture_output=True, text=True, check=True, + ) + m = _CREDITS_RE.search(out.stdout) + return float(m.group(1)) if m else 0.0 + + +def generate( + prompt: str, + image_paths: list[Path], + duration: int = 8, + dry_run: bool = False, + wait_timeout: str = "15m", +) -> tuple[Path, float]: + """Return (local mp4 path, credits spent).""" + if dry_run: + return DEMO_VIDEO, 0.0 + + out = subprocess.run( + ["higgsfield", "generate", "create", MODEL, + *_base_args(prompt, image_paths, duration), + "--wait", "--wait-timeout", wait_timeout, "--json"], + capture_output=True, text=True, check=True, + ) + m = _URL_RE.search(out.stdout) + if not m: + raise RuntimeError(f"Higgsfield returned no result_url:\n{out.stdout[-2000:]}") + url = m.group(1) + credits_m = _CREDITS_RE.search(out.stdout) + credits = float(credits_m.group(1)) if credits_m else 0.0 + + TMP.mkdir(parents=True, exist_ok=True) + dest = TMP / f"base_{uuid.uuid4().hex[:8]}.mp4" + urllib.request.urlretrieve(url, dest) + return dest, credits diff --git a/server/app/pipeline/remotion_render.py b/server/app/pipeline/remotion_render.py new file mode 100644 index 0000000..d184550 --- /dev/null +++ b/server/app/pipeline/remotion_render.py @@ -0,0 +1,90 @@ +"""③ Remotion step — VideoSpec + base video → final mp4 with overlays. + +Generalized: builds a props JSON (video config + default timings + spec content) +and runs `npx remotion render MumumShort --props=`. The base video is +copied into remotion/public/ so OffthreadVideo's staticFile() can resolve it. +""" +from __future__ import annotations + +import json +import shutil +import subprocess +import uuid +from pathlib import Path + +from app.schemas import VideoSpec + +ENGINE = Path(__file__).resolve().parents[3] # engine/higgsfield_shorts +REMOTION = ENGINE / "remotion" +PUBLIC = REMOTION / "public" +OUT_DIR = REMOTION / "out" + +FPS = 30 + + +def _probe_frames(video_path: Path, fps: int = FPS) -> tuple[int, int, int]: + """Return (durationInFrames, width, height) via ffprobe.""" + out = subprocess.run( + ["ffprobe", "-v", "error", "-select_streams", "v:0", + "-show_entries", "stream=width,height,duration", + "-of", "json", str(video_path)], + capture_output=True, text=True, check=True, + ) + info = json.loads(out.stdout)["streams"][0] + width = int(info["width"]) + height = int(info["height"]) + seconds = float(info.get("duration", 8.0)) + return max(1, round(seconds * fps)), width, height + + +def _timings(total: int) -> dict: + """Default 4-beat layout, clamped to the actual video length.""" + def clamp(f: int) -> int: + return max(0, min(f, total)) + return { + "hook": {"fromFrame": 0, "toFrame": clamp(78)}, + "sellingPoint": {"fromFrame": clamp(80), "toFrame": clamp(138)}, + "brandLines": {"fromFrame": clamp(138), "toFrame": clamp(196)}, + "endCard": {"fromFrame": clamp(total - 49), "toFrame": total}, + } + + +def build_props(spec: VideoSpec, base_video: Path) -> tuple[dict, str]: + """Copy base video into public/ and assemble the Remotion props dict.""" + PUBLIC.mkdir(parents=True, exist_ok=True) + job = f"job_{uuid.uuid4().hex[:8]}.mp4" + shutil.copy(base_video, PUBLIC / job) + + frames, width, height = _probe_frames(PUBLIC / job) + t = _timings(frames) + + props = { + "videoSrc": job, + "fps": FPS, "width": width, "height": height, "durationInFrames": frames, + "hook": {"eyebrow": spec.hook.eyebrow, "title": spec.hook.title, **t["hook"]}, + "sellingPoint": {"items": spec.selling_point.items, **t["sellingPoint"]}, + "brandLines": {"lines": spec.brand_lines, **t["brandLines"]}, + "endCard": { + "brand": spec.end_card.brand, + "location": spec.end_card.location, + "disclosure": spec.end_card.disclosure, + **t["endCard"], + }, + } + return props, job + + +def render(spec: VideoSpec, base_video: Path) -> Path: + OUT_DIR.mkdir(parents=True, exist_ok=True) + props, _ = build_props(spec, base_video) + + props_file = OUT_DIR / f"props_{uuid.uuid4().hex[:8]}.json" + props_file.write_text(json.dumps(props, ensure_ascii=False), encoding="utf-8") + + out_file = OUT_DIR / f"final_{uuid.uuid4().hex[:8]}.mp4" + subprocess.run( + ["npx", "remotion", "render", "MumumShort", str(out_file), + f"--props={props_file}"], + cwd=str(REMOTION), check=True, + ) + return out_file diff --git a/server/app/pipeline/spec_builder.py b/server/app/pipeline/spec_builder.py new file mode 100644 index 0000000..5321140 --- /dev/null +++ b/server/app/pipeline/spec_builder.py @@ -0,0 +1,171 @@ +"""① LLM step — interview answers → VideoSpec (JSON). + +Uses the Anthropic Python SDK (claude-opus-4-7) with structured outputs so the +result is guaranteed to match the Remotion data contract. The guardrail system +prompt is cached (stable prefix) to cut cost/latency across requests. +""" +from __future__ import annotations + +import json +import anthropic + +from app.schemas import GenerateRequest, VideoSpec, ScriptResult + +MODEL = "claude-opus-4-7" + +# Stable, cacheable guardrail + role prompt. +SYSTEM_PROMPT = """\ +당신은 한국 로컬 비즈니스(숙소·매장·제품)의 8초 세로형 숏폼 광고 카피 디렉터입니다. +사장/마케터가 직접 답한 정보만으로, 영상 사양(VideoSpec)을 설계합니다. 복잡한 분석은 하지 않습니다. + +[절대 가드레일] +1. 식민지 유산·역사정치 민감 용어 금지: "적산가옥", "일제", "식민지", "근대사" 등 → 미학·경험 어휘로 대체. +2. 거짓·과장 금지: 사용자가 주지 않은 거리(예: "서울 40분")·효능·수치를 지어내지 않는다. 주어진 정보만 사용. +3. 자막은 흰색 모노크롬 전제 — 카피에 색 지시어를 넣지 않는다. +4. AI 디스클로저는 end_card.disclosure에 고정 문구로 포함. + +[hook 작성 — 레퍼런스 바이럴 공식 "[반전/호기심] + [한방]"] +- eyebrow: 짧은 도발/맥락 한 줄 (예: "아무도 모르는 군산"). +- title: 굵은 한방 헤드라인. 사용자의 셀링포인트를 가장 강하게 압축. + +[selling_point.items] 정확히 3개. 사용자 한방 셀링포인트 + 유형 기반의 구체 명사구(짧게). 이모지 금지. + +[brand_lines] 감성 2줄 (각 줄 짧게). 한 덩어리로 읽히게. + +[end_card] brand=업체/상품명, location=주소나 URL(없으면 빈 문자열 ""), disclosure 고정. + +[caption] 업로드용. 정보(업체/주소/가격) + 짧은 감성 + 해시태그 5~8개. 유형에 맞는 해시태그. + +[profile 선택] +- place + 정적/프라이빗/힐링 → "Still Cinema" +- place + 뷰/활동성/포토스팟, 또는 product 일반 → "Rhythm Reveal" +- 파티/워터파크/대형 액티비티 → "Maximum Viral" + +[higgsfield_prompt] 영문. marketing_studio_video tv_spot용. 빠르고 역동적인 카메라(quick punchy moves, crash zoom, kinetic glide). 유형 반영: place=공간 투어, product=제품 쇼케이스. 반드시 "keep structure realistic, do not distort" 포함. +""" + +# Structured-output JSON schema (additionalProperties:false everywhere). +_SPEC_SCHEMA = { + "type": "object", + "additionalProperties": False, + "properties": { + "profile": {"type": "string", "enum": ["Still Cinema", "Rhythm Reveal", "Maximum Viral"]}, + "higgsfield_prompt": {"type": "string"}, + "hook": { + "type": "object", + "additionalProperties": False, + "properties": {"eyebrow": {"type": "string"}, "title": {"type": "string"}}, + "required": ["eyebrow", "title"], + }, + "selling_point": { + "type": "object", + "additionalProperties": False, + "properties": {"items": {"type": "array", "items": {"type": "string"}}}, + "required": ["items"], + }, + "brand_lines": {"type": "array", "items": {"type": "string"}}, + "end_card": { + "type": "object", + "additionalProperties": False, + "properties": { + "brand": {"type": "string"}, + "location": {"type": "string"}, + "disclosure": {"type": "string"}, + }, + "required": ["brand", "location", "disclosure"], + }, + "caption": {"type": "string"}, + }, + "required": [ + "profile", "higgsfield_prompt", "hook", "selling_point", + "brand_lines", "end_card", "caption", + ], +} + + +def build_spec(req: GenerateRequest, client: anthropic.Anthropic | None = None) -> VideoSpec: + client = client or anthropic.Anthropic() + + user_msg = ( + f"유형: {'장소' if req.kind == 'place' else '메시지(축하·안부·홍보)' if req.kind == 'message' else '물건(제품·음식 등 정적 아이템)'}\n" + f"업체/상품명: {req.biz_name}\n" + f"주소/판매URL: {req.addr or '(없음)'}\n" + f"가격: {req.price or '(없음)'}\n" + f"강력한 한방 셀링포인트: {req.selling}\n\n" + "위 정보로 VideoSpec을 설계해줘." + ) + + resp = client.messages.create( + model=MODEL, + max_tokens=2048, + thinking={"type": "adaptive"}, + output_config={ + "effort": "medium", + "format": {"type": "json_schema", "name": "video_spec", "schema": _SPEC_SCHEMA}, + }, + system=[{ + "type": "text", + "text": SYSTEM_PROMPT, + "cache_control": {"type": "ephemeral"}, + }], + messages=[{"role": "user", "content": user_msg}], + ) + + text = "".join(b.text for b in resp.content if b.type == "text") + return VideoSpec.model_validate(json.loads(text)) + + +# ---------- 자막 스크립트 4블록 ---------- +SCRIPT_SYSTEM = """\ +당신은 한국 로컬 비즈니스 숏폼 광고의 자막 스크립트 작가입니다. +사장/마케터가 답한 정보로, 영상에 얹을 4개 블록을 만듭니다. + +[4블록] +- intro: 첫 1~2초 후킹. 호기심·반전을 거는 짧은 한 줄. +- selling: 가장 강력한 셀링포인트를 한 문장으로 압축. +- story: 감성 스토리. 고객이 그 공간/제품에서 느낄 감정을 1~2문장으로. +- cta: 행동 유도. 예약·구매·방문으로 자연스럽게. + +[가드레일] +- 거짓·과장 금지(주어지지 않은 거리·효능·수치 X). 주어진 정보만. +- 식민지 유산 어휘(적산가옥/일제/식민지 등) 금지 → 미학·경험 어휘로. +- 자막은 흰색 모노크롬 전제 — 색 지시어 넣지 않음. 이모지 남발 금지. +- 각 블록은 짧고 입에 붙게. 한국어. +""" + +_SCRIPT_SCHEMA = { + "type": "object", + "additionalProperties": False, + "properties": { + "intro": {"type": "string"}, + "selling": {"type": "string"}, + "story": {"type": "string"}, + "cta": {"type": "string"}, + }, + "required": ["intro", "selling", "story", "cta"], +} + + +def build_script(req: GenerateRequest, client: anthropic.Anthropic | None = None) -> ScriptResult: + client = client or anthropic.Anthropic() + user_msg = ( + f"유형: {'장소' if req.kind == 'place' else '메시지(축하·안부·홍보)' if req.kind == 'message' else '물건(제품·음식 등 정적 아이템)'}\n" + f"업체/상품명: {req.biz_name}\n" + f"주소/판매URL: {req.addr or '(없음)'}\n" + f"가격: {req.price or '(없음)'}\n" + f"강력한 한방 셀링포인트: {req.selling}\n\n" + "위 정보로 4블록 자막 스크립트를 만들어줘." + ) + resp = client.messages.create( + model=MODEL, + max_tokens=1024, + thinking={"type": "adaptive"}, + output_config={ + "effort": "low", + "format": {"type": "json_schema", "name": "script", "schema": _SCRIPT_SCHEMA}, + }, + system=[{"type": "text", "text": SCRIPT_SYSTEM, "cache_control": {"type": "ephemeral"}}], + messages=[{"role": "user", "content": user_msg}], + ) + text = "".join(b.text for b in resp.content if b.type == "text") + return ScriptResult.model_validate(json.loads(text)) diff --git a/server/app/schemas.py b/server/app/schemas.py new file mode 100644 index 0000000..1db6d8c --- /dev/null +++ b/server/app/schemas.py @@ -0,0 +1,64 @@ +"""Pydantic schemas for the Higgsfield Shorts wrapper. + +VideoSpec mirrors the Remotion data contract (remotion/src/data/mumum.ts) 1:1. +The LLM (spec_builder) fills VideoSpec; Higgsfield consumes higgsfield_prompt; +Remotion consumes the rest (hook / selling_point / brand_lines / end_card). +""" +from __future__ import annotations + +from typing import Literal, Optional +from pydantic import BaseModel, Field + + +# ---------- Inbound: interview answers (no complex analysis) ---------- +class GenerateRequest(BaseModel): + kind: Literal["place", "product", "message"] + biz_name: str = Field(..., description="업체명·상품명·메시지 제목") + addr: Optional[str] = Field(None, description="주소 또는 판매 사이트 URL") + price: Optional[str] = Field(None, description="가격 정보") + selling: str = Field(..., description="주인/마케터가 생각하는 강력한 한방 셀링포인트") + + +# ---------- VideoSpec sub-objects (mirror mumum.ts) ---------- +class Hook(BaseModel): + eyebrow: str + title: str + + +class SellingPoint(BaseModel): + items: list[str] = Field(..., description="3개 독립 배지 카피") + + +class EndCard(BaseModel): + brand: str + location: str + disclosure: str = "실제 사진 기반, AI 카메라 효과를 적용한 영상입니다." + + +class VideoSpec(BaseModel): + # 에너지 프로파일 → Remotion 리듬/트랜지션 기본값 결정 + profile: Literal["Still Cinema", "Rhythm Reveal", "Maximum Viral"] + # Higgsfield marketing_studio_video 프롬프트 (유형별 톤) + higgsfield_prompt: str + hook: Hook + selling_point: SellingPoint + brand_lines: list[str] = Field(..., description="감성 카피 2줄") + end_card: EndCard + caption: str = Field(..., description="업로드용 캡션+해시태그") + + +# ---------- Outbound: 자막 스크립트 4블록 ---------- +class ScriptResult(BaseModel): + intro: str = Field(..., description="인트로 (후킹)") + selling: str = Field(..., description="셀링포인트") + story: str = Field(..., description="감성 스토리") + cta: str = Field(..., description="CTA") + + +# ---------- Outbound: final result ---------- +class GenerateResult(BaseModel): + video_url: str + caption: str + profile: str + cost_credits: float = 0.0 + job_id: Optional[str] = None diff --git a/server/pyproject.toml b/server/pyproject.toml new file mode 100644 index 0000000..fa296a1 --- /dev/null +++ b/server/pyproject.toml @@ -0,0 +1,15 @@ +[project] +name = "ado2-higgsfield-server" +version = "0.1.0" +description = "ADO2 Higgsfield Shorts wrapper — LLM + Higgsfield + Remotion orchestration" +requires-python = ">=3.12" +dependencies = [ + "fastapi>=0.115", + "uvicorn[standard]>=0.30", + "python-multipart>=0.0.9", + "anthropic>=0.69", + "pydantic>=2.7", +] + +[tool.uvicorn] +# run: uv run uvicorn app.main:app --reload --port 8000 diff --git a/webapp/.gitignore b/webapp/.gitignore new file mode 100644 index 0000000..e985853 --- /dev/null +++ b/webapp/.gitignore @@ -0,0 +1 @@ +.vercel diff --git a/webapp/assets/ado2-logo-white.png b/webapp/assets/ado2-logo-white.png new file mode 100644 index 0000000..e3ceae5 Binary files /dev/null and b/webapp/assets/ado2-logo-white.png differ diff --git a/webapp/demo/mumum.mp4 b/webapp/demo/mumum.mp4 new file mode 100644 index 0000000..f0922fb Binary files /dev/null and b/webapp/demo/mumum.mp4 differ diff --git a/webapp/index.html b/webapp/index.html new file mode 100644 index 0000000..4886459 --- /dev/null +++ b/webapp/index.html @@ -0,0 +1,589 @@ + + + + +ADO2 Hookit — 8초 숏폼 생성기 + + + + +

+ + + + + + + + diff --git a/webapp/vercel.json b/webapp/vercel.json new file mode 100644 index 0000000..9ea00f5 --- /dev/null +++ b/webapp/vercel.json @@ -0,0 +1,15 @@ +{ + "$schema": "https://openapi.vercel.sh/vercel.json", + "cleanUrls": true, + "trailingSlash": false, + "headers": [ + { + "source": "/demo/(.*)", + "headers": [{ "key": "Cache-Control", "value": "public, max-age=86400" }] + }, + { + "source": "/assets/(.*)", + "headers": [{ "key": "Cache-Control", "value": "public, max-age=86400" }] + } + ] +}