WAVE SDK for Python

Media infrastructure for the agentic internet. Official Python SDK for WAVE, by WAVE Online, LLC.

Installation

pip install wave-sdk

Quick start

from wave_sdk import Wave

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

# Search your organization's indexed media
results = client.search.search(query="product launch")

# List your org's published pricing tiers (requires the pricing:read scope)
manifests = client.pricing.list_manifests()

# Transcribe a recording and auto-generate captions for it
transcription = client.transcribe.create(source_url="https://example.com/clip.mp4")
captions = client.captions.generate(media_id=transcription.id, media_type="video")

# Propose a plan across WAVE products for a plain-English intent (requires
# composer:write). A proposal never executes anything.
proposal = client.compose.compose("live captions for tomorrow's webinar")
print(proposal.stages, proposal.price_rows, proposal.executes)  # executes is always False

All 43 APIs

P1 - Core

P2 - Enterprise

P3 - Content & Commerce

P4 - Specialized

Cross-cutting

Agent-native and comms productization (2.1.0)

Composer (PR4)

wave.compose.compose(intent, ...) never executes anything — the response's executes field is a literal False. wave.compose.save_flow(proposal) saves the proposal as a flow with createdBy.kind: "wave-composer"; until a composer:write console token exists, it never calls the console silently — it prints (and returns) the exact curl a signed-in console session can run:

proposal = client.compose.compose("live captions for tomorrow's webinar", budget_usd=5)
curl_cmd = client.compose.save_flow(proposal)  # prints the curl; does not save it itself

Error handling

from wave_sdk import WaveError, RateLimitError

try:
    client.clips.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

Migrating from 2.0.0

If you installed wave-av-sdk or wave-sdk at 2.0.0, two names changed:

• Install wave-sdk (not wave-av-sdk).
• Import wave_sdk (not wave).

-from wave import Wave
+from wave_sdk import Wave

Nothing below the top-level name changed, so replacing the import line is the whole migration. The old wave package collided with the Python standard library's own wave module and was never importable from an installed 2.0.0 — full detail, the uninstall step, and a bulk find-and-replace are in MIGRATING.md.

Note that the wave.<api> names in the tables above are attributes of a client instance, not module paths: name your client whatever you like (client = Wave(...) in the quick start above), and client.clips is the row the table writes as wave.clips.

License

Apache-2.0 - WAVE Online, LLC. See LICENSE and NOTICE; the WAVE marks are not licensed under the Apache grant.