Venice Video Harness

​

이것은 무엇인가요

• CLAUDE.md의 오케스트레이션 규칙
• .claude/commands/의 재사용 가능한 플레이북(19개의 워크플로 명령)
• .claude/agents/의 전문 에이전트(art-director, prompt-engineer, cut-qa 등)
• .claude/skills/의 Venice 프로덕션 스킬(Agent Skills 포맷과 호환)
• src/의 TypeScript 실행 레이어
• 50개 이상의 Venice 비디오, 이미지, 오디오, 음악 모델을 다루는 포괄적 모델 레지스트리

• 캐릭터 일관성이 있는 비디오 프로젝트(장르 무관, 길이 무관)
• 비주얼 스타일이 고정된 시리즈 또는 캠페인
• 스토리보드→비디오 워크플로
• 숏폼 및 롱폼 내러티브 콘텐츠
• 브랜드 시네마틱 시퀀스, 트레일러, 티저
• 반복 등장 캐릭터의 소셜 시리즈

​

시작하기

​

요구사항

brew install whisper-cpp
mkdir -p ~/.cache/whisper.cpp
curl -L -o ~/.cache/whisper.cpp/ggml-base.en.bin \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin

​

설정

git clone https://github.com/jordanurbs/venice-video-harness.git
cd venice-video-harness

cp .env.example .env
# .env에 VENICE_API_KEY 추가

npm install
npm run build

​

무엇이 Venice에 최적화되어 있나요

• seedream-v5-lite, nano-banana-pro, flux-2-pro/max 등 Venice 이미지 모델용으로 튜닝된 이미지 prompt
• 캐릭터 보정을 위한 Venice multi-edit 리파인이 포함된 2패스 패널 생성
• 액션, 분위기, 캐릭터 일관성 등급을 위한 모델 라우팅 로직
• 모델별로 elements, reference_image_urls, scene_image_urls를 올바르게 사용하는 레퍼런스 인식 비디오 생성
• 낮 대 밤 장면 처리를 위한 환경 인식 prompt 적응
• TTS(Kokoro, Qwen3, ElevenLabs), SFX, 음악을 위한 Venice 네이티브 오디오 경로
• /video/quote와 /audio/quote를 통한 생성 전 비용 추정
• 타겟 모델이 지원하지 않는 파라미터를 자동으로 건너뛰는 모델 인식 파라미터 빌더

​

모델 라우팅 기본값

​

지원되는 Venice 모델

​

비디오 (2026년 4월)

​

이미지, 오디오, 음악

• 이미지(22개 이상 모델): nano-banana-pro/2, gpt-image-2, flux-2-pro/max, grok-imagine, qwen-image-2-pro, recraft-v4-pro, seedream-v4 / v5-lite, lustify-sdxl/v7, wai-Illustrious 등
• Multi-edit: qwen-edit, flux-2-max-edit, nano-banana-pro-edit, seedream-v5-lite-edit, gpt-image-2-edit 등
• TTS: tts-kokoro(50개 이상 음성), tts-qwen3-0-6b/1-7b, elevenlabs-tts-v3, elevenlabs-tts-multilingual-v2
• 음악: elevenlabs-music, minimax-music-v2, ace-step-15, stable-audio-25
• SFX: elevenlabs-sound-effects-v2, mmaudio-v2-text-to-audio

​

프로덕션 파이프라인

​

생성 파이프라인

npm run dev -- produce-episode -p output/my-series -e 1

• 시리즈 / 캐릭터 / 에피소드 관리
• LLM 기반 스크립트 워크숍
• 2패스 스토리보드 생성(생성 + multi-edit 리파인)
• 비전 기반 패널 QA
• 프레임 체이닝이 있는 비디오 생성
• 레이어드 오디오 포스트 프로덕션
• 자막 번인과 최종 어셈블리

​

편집 파이프라인

​

명령, 에이전트, 스킬

​

NLE 라운드 트립

mini-drama export-timeline -p output/<project> -e 1 --format fcpxml      # Final Cut Pro X
mini-drama export-timeline -p output/<project> -e 1 --format premiere    # Premiere Pro
mini-drama export-timeline -p output/<project> -e 1 --format davinci     # DaVinci Resolve

​

프로그래밍 방식 사용

import { VeniceClient } from './src/venice/client.js';
import { generateVideo, quoteVideo } from './src/venice/video.js';
import { listVideoModels } from './src/venice/models.js';

const client = new VeniceClient();

const quote = await quoteVideo(client, {
  model: 'kling-v3-pro-image-to-video',
  duration: '8s',
  audio: true,
});
console.log(`Estimated cost: $${quote.quote}`);

const result = await generateVideo(client, {
  model: 'kling-v3-pro-image-to-video',
  prompt: 'A slow dolly shot pushes forward...',
  duration: '8s',
  imageUrl: 'data:image/png;base64,...',
  audio: true,
  outputPath: 'output/shot-001.mp4',
});

const longModels = listVideoModels({ minDurationSec: 20 });

​

리소스