Venice Video Harness

​

Cos’è

• Regole di orchestrazione in CLAUDE.md
• Playbook riutilizzabili in .claude/commands/ (19 comandi di workflow)
• Agenti specializzati in .claude/agents/ (art-director, prompt-engineer, cut-qa e altri)
• Skill di produzione Venice in .claude/skills/ (compatibili con il formato Agent Skills)
• Livello di esecuzione TypeScript in src/
• Registry completo dei modelli che copre oltre 50 modelli Venice per video, immagini, audio e musica

• Progetti video character-consistent (qualsiasi genere, qualsiasi durata)
• Serie o campagne con stile visivo bloccato
• Workflow storyboard-to-video
• Contenuti narrativi short-form e long-form
• Sequenze cinematiche brandizzate, trailer e teaser
• Serie social con personaggi ricorrenti

​

Per iniziare

​

Requisiti

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

​

Setup

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

cp .env.example .env
# Aggiungi VENICE_API_KEY a .env

npm install
npm run build

​

Cosa lo rende Venice-optimized

• Prompt per immagini ottimizzati per i modelli di immagini Venice come seedream-v5-lite, nano-banana-pro, flux-2-pro/max e altri
• Generazione dei pannelli a due passaggi con raffinamento multi-edit Venice per la correzione dei personaggi
• Logica di routing dei modelli per i tier di azione, atmosfera e character-consistency
• Generazione video reference-aware che usa elements, reference_image_urls e scene_image_urls correttamente per ogni modello
• Adattamento del prompt environment-aware per la gestione delle scene diurne vs notturne
• Percorsi audio Venice-native per TTS (Kokoro, Qwen3, ElevenLabs), SFX e musica
• Stima dei costi prima della generazione tramite /video/quote e /audio/quote
• Costruzione dei parametri model-aware che salta automaticamente i parametri non supportati dal modello target

​

Default di routing dei modelli

​

Modelli Venice supportati

​

Video (aprile 2026)

​

Immagine, audio e musica

• Immagine (22+ modelli): 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 e altri
• Multi-edit: qwen-edit, flux-2-max-edit, nano-banana-pro-edit, seedream-v5-lite-edit, gpt-image-2-edit e altri
• TTS: tts-kokoro (50+ voci), tts-qwen3-0-6b/1-7b, elevenlabs-tts-v3, elevenlabs-tts-multilingual-v2
• Musica: elevenlabs-music, minimax-music-v2, ace-step-15, stable-audio-25
• SFX: elevenlabs-sound-effects-v2, mmaudio-v2-text-to-audio

​

Pipeline di produzione

​

Pipeline di generazione

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

• Gestione di serie / personaggi / episodi
• Workshop di script con LLM
• Generazione dello storyboard a due passaggi (genera + raffina multi-edit)
• QA dei pannelli basato su vision
• Generazione video con frame chaining
• Post-produzione audio a strati
• Burn-in dei sottotitoli e montaggio finale

​

Pipeline di editing

​

Comandi, agenti e skill

​

Round-trip 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

​

Utilizzo programmatico

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

​

Risorse