Skip to main content

​
VideoAgent

Defined in the video_agent module.
A specialized agent for generating videos using AI models. This agent provides a simple, agent-centric interface for video generation with support for multiple providers (OpenAI Sora, Azure, Gemini Veo, Vertex AI, RunwayML). Supported Providers:
  • OpenAI: openai/sora-2, openai/sora-2-pro
  • Azure: azure/sora-2, azure/sora-2-pro
  • Gemini: gemini/veo-3.0-generate-preview, gemini/veo-3.1-*
  • Vertex AI: vertex_ai/veo-3.0-, vertex_ai/veo-3.1-
  • RunwayML: runwayml/gen4_turbo (requires input_reference)

​
Constructor

​
name
Optional
No description available.
​
instructions
Optional
No description available.
​
llm
Optional
No description available.
​
model
Optional
No description available.
​
base_url
Optional
No description available.
​
api_key
Optional
No description available.
​
api_version
Optional
No description available.
​
video
Optional
No description available.
​
verbose
Union
default:"True"
No description available.
​
output
Optional
No description available.

​
Methods

console()

Lazily initialize Rich Console.

video_module()

Lazy load litellm.videos module when needed.

generate()

Generate a video from a text prompt.

agenerate()

Async version of generate().

status()

Check the status of a video generation.

astatus()

Async version of status().

content()

Download the video content.

acontent()

Async version of content().

list()

List all videos for the current account.

alist()

Async version of list().

remix()

Remix/edit an existing video.

aremix()

Async version of remix().

wait_for_completion()

Wait for video generation to complete.

await_completion()

Async version of wait_for_completion().

start()

Generate video with optional wait and file output.

astart()

Async version of start().

run()

Generate video silently (production use).

arun()

Async version of run().

download()

Download a video to a file.

adownload()

Async version of download().

​
Usage

from praisonaiagents import VideoAgent
    
    # Simple usage
    agent = VideoAgent(llm="openai/sora-2")
    video = agent.generate(prompt="A cat playing with yarn")
    
    # Wait for completion
    video = agent.start(
        prompt="A serene lake at sunset",
        wait=True,  # Wait for completion
        output="video.mp4"  # Save to file
    )
    
    # With config
    agent = VideoAgent(
        llm="gemini/veo-3.0-generate-preview",
        video=VideoConfig(seconds="8", size="1280x720")
    )