Providers

Configure and use different video generation providers with MiniStudio

Available Providers

VertexAIProvider

Generate videos using Google Vertex AI

from ministudio.providers import VertexAIProvider

provider = VertexAIProvider(
    api_key="your-api-key",
    project_id="your-project-id",
    location="us-central1"
)

MockVideoProvider

Perfect for testing and development (no API keys needed)

from ministudio.providers import MockVideoProvider

provider = MockVideoProvider()
The MockVideoProvider returns placeholder videos instantly, making it ideal for testing workflows.

Custom Provider (Coming Soon)

Implement your own provider by extending the VideoProvider base class.

Provider Configuration

Environment Variables

# Google Vertex AI
export GOOGLE_API_KEY="your-api-key"
export GOOGLE_PROJECT_ID="your-project-id"
export GOOGLE_LOCATION="us-central1"

Configuration File

Create ministudio.yaml:

provider:
  type: vertex_ai
  api_key: ${GOOGLE_API_KEY}
  project_id: ${GOOGLE_PROJECT_ID}
  location: us-central1
  timeout_seconds: 600

Switching Providers

from ministudio import VideoOrchestrator
from ministudio.providers import VertexAIProvider, MockVideoProvider

# Use Vertex AI for production
if environment == "production":
    provider = VertexAIProvider()
else:
    # Use mock for development
    provider = MockVideoProvider()

orchestrator = VideoOrchestrator(provider)

Provider Methods

generate_video()

Core method for video generation

async def generate_video(
    request: VideoGenerationRequest
) -> VideoGenerationResult

is_available()

Check if the provider is available and configured

if provider.is_available():
    # Provider is ready to use
    result = await orchestrator.generate_shot(request)