WAVE SDK
TypeScript. Python. 120+ endpoints. Ship in hours.
Build streaming into your product with fully typed SDKs, 120+ API endpoints, signed webhooks, and an embeddable player. From first API call to production in hours.
Everything you need to build
SDKs, CLI, webhooks, embeddable player. One platform, every tool a developer needs.
TypeScript + Python SDKs
Fully typed SDKs for TypeScript and Python. Auto-generated from OpenAPI spec. IntelliSense, type safety, and comprehensive JSDoc.
API key management
Scoped API keys with per-key permissions, rate limits, and expiration. Rotate keys without downtime. Audit log for every API call.
CLI tool
WAVE CLI for stream management, deployment, and debugging. Pipe-friendly output. Shell completions for bash, zsh, and fish.
Webhooks
Real-time event notifications via signed webhooks. 40+ event types covering streams, viewers, billing, and infrastructure. Retry with exponential backoff.
Embeddable player
Drop-in video player component for React, Vue, and vanilla JS. Adaptive bitrate, DRM, captions, and analytics built in.
Interactive docs
API reference with live code examples. Try endpoints directly from the docs. Copy-paste code snippets in your language of choice.
Technical specifications
Three steps to your first stream
Install the SDK
npm install @wave-av/sdk or pip install wave-sdk. TypeScript types included. Zero configuration needed.
Create a stream
One API call to create a stream. Get an ingest URL and playback URL. Start sending video via RTMP, SRT, or WebRTC.
Embed the player
Drop the WAVE player component into your app. Adaptive bitrate, DRM, and analytics work out of the box.
Built for developers
Frequently asked questions
How do I get API keys?
Sign up for a free WAVE account. API keys are available in the dashboard under Settings > API Keys. Create scoped keys with specific permissions (read-only, stream management, billing) and set rate limits per key.
Is there a free tier for the API?
Yes. The free tier includes 1000 API requests per minute, 10 concurrent streams, and full SDK access. Upgrade for higher limits and premium features.
How are webhooks secured?
Every webhook payload is signed with HMAC-SHA256 using your webhook secret. Verify the X-Wave-Signature header to confirm authenticity. Webhooks retry up to 5 times with exponential backoff on failure.
Can I use the SDK with my existing video infrastructure?
Yes. The WAVE SDK supports BYOC (bring your own CDN) mode. Use WAVE for stream management and analytics while delivering through your existing CDN. The embeddable player works with any HLS/DASH source.