Skip to main content

WAVE SDK for Python

Official Python SDK for the WAVE API by WAVE Online, LLC

Installation

pip install wave-av-sdk

Quick start

from wave_sdk import Wave

wave = Wave(api_key="your-api-key", organization_id="org_123")

# Create and start a live stream
stream = wave.pipeline.create(title="My Stream", protocol="webrtc")
wave.pipeline.start(stream.id)
health = wave.pipeline.get_health(stream.id)
print(f"Viewers: {health['viewer_count']}")

# Create a virtual camera from NDI
device = wave.prism.create_device(
    name="PTZ Camera 1",
    type="camera",
    source_protocol="ndi",
    source_endpoint="NDI-CAM-1",
    node_id="node_abc",
    ptz_enabled=True,
)

# Get analytics
viewers = wave.pulse.get_viewer_analytics(time_range="24h")

All 33 APIs

P1 - Core

API Description
wave.pipeline Live streaming engine
wave.studio Multi-camera production

P2 - Enterprise

API Description
wave.fleet Device fleet management
wave.ghost AI auto-directing
wave.mesh Multi-region failover
wave.edge CDN and edge workers
wave.pulse Analytics and BI
wave.prism Virtual Device Bridge
wave.zoom Zoom integration

P3 - Content & Commerce

API Description
wave.clips Video clips
wave.editor Video editor
wave.voice Voice synthesis
wave.phone Phone calls
wave.collab Collaboration
wave.captions Auto-captions
wave.chapters Video chapters
wave.studio_ai AI assistant
wave.transcribe Transcription
wave.sentiment Sentiment analysis
wave.search Content search
wave.scene Scene detection
wave.vault Recording storage
wave.marketplace Marketplace
wave.connect Integrations
wave.distribution Social simulcast
wave.desktop Desktop Node
wave.signage Digital signage
wave.qr QR codes
wave.audience Polls/Q&A
wave.creator Monetization

P4 - Specialized

API Description
wave.podcast Podcast production
wave.slides Slides-to-video
wave.usb USB relay

Error handling

from wave_sdk import WaveError, RateLimitError

try:
    wave.pipeline.get("invalid-id")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except WaveError as e:
    print(f"{e.code}: {e.message} ({e.status_code})")

Requirements

  • Python 3.9+
  • httpx
  • pydantic

License

MIT - WAVE Online, LLC

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wave_av_sdk-3.0.0.tar.gz (36.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wave_av_sdk-3.0.0-py3-none-any.whl (50.9 kB view details)

Uploaded Python 3

File details

Details for the file wave_av_sdk-3.0.0.tar.gz.

File metadata

  • Download URL: wave_av_sdk-3.0.0.tar.gz
  • Upload date:
  • Size: 36.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wave_av_sdk-3.0.0.tar.gz
Algorithm Hash digest
SHA256 de314a58ac768d774cdba214b1f762a315a8440cd2371d8eb7d69676ab79b965
MD5 5e324531b84fe17b5725650e01472b1c
BLAKE2b-256 504bbaf6818e5e40aeb54a18ca1b924bf39835862abe9e92d6b759c4ab667318

See more details on using hashes here.

Provenance

The following attestation bundles were made for wave_av_sdk-3.0.0.tar.gz:

Publisher: publish-pypi.yml on wave-av/sdks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file wave_av_sdk-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: wave_av_sdk-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 50.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wave_av_sdk-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a8211454da8e5b4f176c174013079b45112f2f82c09a27ddf4666006016b7d2d
MD5 25ee9faef0df48eb876065f3b23eac61
BLAKE2b-256 69195471ca4268c8adf50905536e58400843528dd611b3c05c575a15b73c5ed1

See more details on using hashes here.

Provenance

The following attestation bundles were made for wave_av_sdk-3.0.0-py3-none-any.whl:

Publisher: publish-pypi.yml on wave-av/sdks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

3.0.0 This release

2 files

2.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page