---
id: vonage-video
version: "1.5.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-video — Vonage video package

License: permissive · Maintenance: active · Downloads: 336.8K/mo

## What it is and what it does

vonage-video is a Python SDK for Vonage's Video API, designed to be used as part of the main vonage package. It provides a structured interface to video session management, stream control, real-time signaling, and media composition. The package uses Pydantic data models for type-safe API calls, covering operations like session creation, token generation, stream muting, layout configuration, and archive/broadcast management.

The library handles complex video workflows including live streaming to multiple RTMP destinations, HLS broadcast configuration, SIP call initiation, DTMF tone playback, and caption management. It abstracts the underlying HTTP API calls through vonage-http-client while relying on pydantic for request/response validation, making it suitable for building video conferencing, live-streaming, and telephony integration features into Python applications.

Use it for:

- Build a video conferencing application that needs to create sessions, manage participant streams, and control audio/video muting.
- Set up live streaming to YouTube or other RTMP platforms with layout customization and DVR/low-latency HLS options.
- Integrate SIP calling into a video application, allowing traditional phone calls to join video sessions.
- Record and archive video sessions with selective stream inclusion and layout composition.
- Send real-time signals (chat, notifications) between video participants within a session.
- Implement automated caption management and audio connector features for accessibility or third-party audio processing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for Vonage's Video API, providing methods to manage video sessions, streams, archives, broadcasts, and real-time communications like SIP calls and DTMF signaling.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. It is purpose-built for Vonage Video API integration and provides a clean, type-safe interface via Pydantic models. Install it if you are building on the Vonage platform and need video session, streaming, or call management; avoid it if you are using a different video API provider.

## Install

pip install vonage-video
uv add vonage-video
poetry add vonage-video

## Installing vonage-video

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with recent commits and a stable release cadence. Depends on vonage-http-client, vonage-utils, and pydantic—all standard, well-maintained packages.

License in practice: Licensed under the Apache License (permissive treatment), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install vonage-video

from vonage_video import TokenOptions
from vonage import Vonage

vonage_client = Vonage(...)  # Initialize with credentials
token_options = TokenOptions(session_id='your_session_id', role='publisher')
client_token = vonage_client.video.generate_client_token(token_options)

Requires a Vonage account and API credentials to initialize the vonage.Vonage client; this package is designed to be used as part of the main vonage package.

Verify before relying:

- Whether the package is actively used in production by Vonage customers or primarily for internal/SDK integration.
- Performance characteristics and rate-limit handling for high-volume session or stream operations.
- Backward compatibility guarantees across minor and patch versions.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 336.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vonage video api python, video session management sdk, live streaming broadcast api, video archive and recording, sip calling integration, real-time video communication, stream muting and layout control, video-api, vonage-sdk, real-time-communication

[View on SkillFed](https://skillfed.io/packages/vonage-video) · [View on PyPI](https://pypi.org/project/vonage-video/)