Venice Video Harness

​

ما هذا

• قواعد التنسيق في CLAUDE.md
• سجلات تشغيل قابلة لإعادة الاستخدام في .claude/commands/ (19 أمر سير عمل)
• وكلاء متخصّصون في .claude/agents/ (مخرج فني، مهندس طلبات، فحص جودة القص، وغيرهم)
• مهارات إنتاج Venice في .claude/skills/ (متوافقة مع تنسيق Agent Skills)
• طبقة تنفيذ TypeScript في src/
• سجل نماذج شامل يغطي أكثر من 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
# أضف VENICE_API_KEY إلى .env

npm install
npm run build

​

ما الذي يجعله محسّنًا لـ Venice

• طلبات الصور مضبوطة لنماذج صور Venice مثل seedream-v5-lite وnano-banana-pro وflux-2-pro/max وغيرها
• توليد اللوحات بمرورين مع تحسين متعدد عبر Venice multi-edit لتصحيح الشخصيات
• منطق توجيه النماذج لطبقات الحركة والأجواء واتساق الشخصيات
• توليد فيديو مدرك للمراجع يستخدم elements وreference_image_urls وscene_image_urls بشكل صحيح لكل نموذج
• تكييف الطلبات وفق البيئة للتعامل مع المشاهد النهارية مقابل الليلية
• مسارات صوتية أصلية لـ Venice لـ TTS (Kokoro، Qwen3، ElevenLabs) والمؤثرات الصوتية والموسيقى
• تقدير التكلفة قبل التوليد عبر /video/quote و/audio/quote
• بناء معاملات مدرك للنموذج يتجاوز تلقائيًا المعاملات التي لا يدعمها النموذج المستهدف

​

افتراضيات توجيه النماذج

​

نماذج Venice المدعومة

​

الفيديو (أبريل 2026)

​

الصورة والصوت والموسيقى

• الصورة (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
• المؤثرات الصوتية: elevenlabs-sound-effects-v2، mmaudio-v2-text-to-audio

​

خطوط الإنتاج

​

خط أنابيب التوليد

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

• إدارة السلاسل / الشخصيات / الحلقات
• ورش كتابة سيناريو مدعومة بـ LLM
• توليد لوحة قصصية بمرورين (توليد + تحسين متعدد)
• فحص جودة اللوحات قائم على الرؤية
• توليد الفيديو مع تسلسل الإطارات
• ما بعد إنتاج صوتي طبقي
• حرق الترجمة والتجميع النهائي

​

خط أنابيب التحرير

​

الأوامر والوكلاء والمهارات

​

دورة كاملة مع 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 });

​

المصادر