hasna/video

Video Generation Skill

Generate high-quality videos using state-of-the-art AI models from multiple providers.

This CLI is API-backed. Set SKILL_API_KEY when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.

Supported Providers

Google Veo 3.1 (via Vertex AI)

• State-of-the-art video generation
• Up to 4K resolution support
• Advanced cinematography controls (lens types, camera movements)
• Text-to-video generation

OpenAI Sora

• Text-to-video generation
• High-quality video synthesis
• Note: Requires API access

Runway (Gen-2/Gen-3)

• Professional video generation
• Fast generation times
• API-first approach

Usage

Generate a video

bun run src/index.ts generate --provider google --prompt "a cat walking on a beach at sunset" --output ./output.mp4
bun run src/index.ts generate --provider runway --prompt "ocean waves crashing" --output ./waves.mp4
bun run src/index.ts generate --provider openai --prompt "city street timelapse" --output ./city.mp4

Check generation status

bun run src/index.ts status --provider google --job-id abc123

Advanced options

bun run src/index.ts generate \
  --provider google \
  --prompt "cinematic shot of a forest" \
  --duration 5 \
  --resolution 1080p \
  --output ./forest.mp4

Environment Variables

Set up your API keys:

# Google Veo 3.1 (Vertex AI)
export GOOGLE_API_KEY=your_key_here
# or
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# OpenAI Sora
export OPENAI_API_KEY=your_key_here

# Runway
export RUNWAY_API_KEY=your_key_here

Installation

cd skill-video
bun install

Features

• Asynchronous video generation with job tracking
• Automatic status polling
• Download management
• Support for multiple output formats
• Clean TypeScript implementation
• Provider-agnostic interface

Examples

Quick generation

bun run src/index.ts generate --provider google --prompt "a dog playing fetch"

With cinematography controls (Google Veo 3.1)

bun run src/index.ts generate \
  --provider google \
  --prompt "wide-angle shot of mountains, slow dolly forward" \
  --output ./mountains.mp4

Check status and download

# Start generation
bun run src/index.ts generate --provider runway --prompt "sunset" --output ./sunset.mp4

# Check status with returned job ID
bun run src/index.ts status --provider runway --job-id job_xyz789