Advanced SDK

The SDK is the public wavebird package for consumer AI app teams that need package-level control over ad requests, decisions, rendering helpers, consent, generation lifecycle events, and beacons.

Start with Server API or Script Tag when hosted defaults are enough. Use the SDK when framework ergonomics, migration constraints, or package-level control over the same production API justify the package layer. Teams moving existing package integrations can follow the SDK-first migration guide.

npm package: wavebird →GitHub repository: wavebird-ai/wavebird →

sdk.ts

typescript

TERTIARY
1import { WavebirdClient } from "wavebird";23const client = new WavebirdClient({4  baseUrl: "https://api.wavebird.ai",5  getApiKey: () => process.env.WAVEBIRD_SECRET_KEY ?? "",6});78const job = await client.createJob({9  client_id: process.env.WAVEBIRD_CLIENT_ID,10  job_type: "chat",11  slots_requested: 1,12});

Use only when needed

When the SDK still makes sense

Typed client ergonomics

Helpful when your team wants a typed client wrapper around jobs, decisions, and beacons.

React rendering helpers

Useful if you specifically want component-level rendering helpers on top of the public API flow.

Compatibility path

Useful when you are migrating an existing SDK-based integration but want the docs and contracts to stay API-first.

Install command: npm install wavebird

Open full SDK docs →

Need rollout review?

Start with the Server API. Use contact only when you need rollout review, enterprise coordination, or non-standard integration help.

Contact the team