Venice Video Harness

​

这是什么

• CLAUDE.md 中的编排规则
• .claude/commands/ 中的可复用 playbook（19 个工作流命令）
• .claude/agents/ 中的专用 agent（art-director、prompt-engineer、cut-qa 等）
• .claude/skills/ 中的 Venice 生产 skill（与 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
# Add VENICE_API_KEY to .env

npm install
npm run build

​

它的 Venice 优化体现在哪里

• 针对 Venice 图像模型调优的图像 prompt，如 seedream-v5-lite、nano-banana-pro、flux-2-pro/max 等
• 两阶段面板生成，采用 Venice 多重编辑细化进行角色校正
• 针对动作、氛围和角色一致性层级的模型路由逻辑
• 参考感知的视频生成，按模型正确使用 elements、reference_image_urls 和 scene_image_urls
• 环境感知的 prompt 调整，处理白天 vs 夜晚场景
• Venice 原生音频路径用于 TTS（Kokoro、Qwen3、ElevenLabs）、SFX 和音乐
• 通过 /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 等
• 多重编辑： 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 驱动的脚本工作坊
• 两阶段故事板生成（生成 + 多重编辑细化）
• 基于视觉的面板 QA
• 带帧链接的视频生成
• 分层音频后期制作
• 字幕烧录和最终组装

​

编辑流水线

​

命令、Agent 和 Skill

​

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 });

​

资源