Skip to main content

​
Overview

Omi streams raw audio bytes from your device to any webhook endpoint you configure. Use this to build custom audio processing, live transcription, or recording workflows.

Any Backend

Stream to your own server, cloud function, or local dev environment

Configurable Interval

Choose how often you receive audio chunks (e.g. every 5, 10, or 30 seconds)

Raw Audio

Receive raw PCM bytes — add a WAV header to save as audio files

​
Setup

Create a Webhook Endpoint

Build an endpoint that accepts POST requests with raw audio bytes.Omi sends requests in this format:
POST /your-endpoint?sample_rate=16000&uid=user123
Content-Type: application/octet-stream

[raw audio bytes]
ParameterDescription
sample_rateAudio samples per second (see table below)
uidThe user’s unique ID in Omi
BodyRaw PCM audio bytes (application/octet-stream)
DeviceSample Rate
Omi (consumer)16,000 Hz
DevKit 216,000 Hz
DevKit 1 (v1.0.4+)16,000 Hz
DevKit 1 (v1.0.2)8,000 Hz

Configure in the Omi App

  1. Open the Omi app
  2. Go to Settings → Developer Mode
  3. Scroll to Realtime audio bytes
  4. Enter your webhook URL
  5. Set the interval (e.g. 10 for every 10 seconds)

Verify

Audio bytes should start arriving at your endpoint. The data is raw PCM — to save as a playable audio file, prepend a WAV header to the accumulated bytes.

​
Example: Save to Google Cloud Storage

A complete example that saves audio chunks as WAV files in GCS.

Set Up GCS

Follow the Cloud Audio Storage guide to create a bucket and get credentials.

Deploy the Example

  1. Fork github.com/mdmohsin7/omi-audio-streaming
  2. Clone and deploy to any cloud provider (GCP, AWS, DigitalOcean) or run locally with ngrok
  3. Set these environment variables:
VariableValue
GOOGLE_APPLICATION_CREDENTIALS_JSONBase64-encoded GCP key
GCS_BUCKET_NAMEYour bucket name
The repo includes a Dockerfile for easy deployment.

Connect

Set the endpoint in the Omi app under Realtime audio bytes to:
https://your-deployment.com/audio
Audio files will appear in your GCS bucket at the configured interval.

Cloud Audio Storage

Set up GCS bucket and credentials

Build Apps

Create Omi apps with audio capabilities