SDKs

SDK families

Two SDK families exist. Choose based on what you are building:

Studio SDK

The Studio SDK is auto-generated from the Studio OpenAPI spec by Speakeasy and maintained in the official Livepeer repositories. It is the recommended choice for production applications.

TypeScript / JavaScript

npm install livepeer

npm: https://www.npmjs.com/package/livepeer
GitHub: https://github.com/livepeer/livepeer-js
Version: 3.5.0

All Studio API resources are available under namespaced clients:

import { Livepeer } from 'livepeer';
const client = new Livepeer({ apiKey: process.env.LIVEPEER_API_KEY });

// Video
client.stream.create(...)
client.stream.get(streamId)
client.asset.create(...)
client.asset.get(assetId)
client.webhook.create(...)
client.signingKey.create()

// AI inference
client.generate.textToImage(...)
client.generate.imageToImage(...)
client.generate.imageToVideo(...)
client.generate.audioToText(...)
client.generate.llm(...)

Python

pip install livepeer

PyPI: https://pypi.org/project/livepeer/
GitHub: https://github.com/livepeer/livepeer-python

from livepeer import Livepeer
client = Livepeer(api_key=os.environ['LIVEPEER_API_KEY'])

Go

go get github.com/livepeer/livepeer-go

GitHub: https://github.com/livepeer/livepeer-go

import livepeer "github.com/livepeer/livepeer-go"
client := livepeer.New(livepeer.WithSecurity(os.Getenv("LIVEPEER_API_KEY")))

React UI Kit

npm install @livepeer/react

npm: https://www.npmjs.com/package/@livepeer/react
GitHub: https://github.com/livepeer/ui-kit
Version: 4.3.2

The UI Kit provides composable video primitives for React applications. Key components:

Player — HLS and WebRTC playback with automatic protocol selection, keyboard shortcuts, and PictureInPicture
Broadcast — In-browser RTMP/WebRTC broadcasting
Controls — Play, volume, fullscreen, and quality controls

import * as Player from '@livepeer/react/player';

<Player.Root src="https://livepeercdn.studio/hls/{playbackId}/index.m3u8">
  <Player.Container>
    <Player.Video />
    <Player.Controls />
  </Player.Container>
</Player.Root>

AI SDK (alpha)

The AI SDK is generated separately from the AI gateway OpenAPI spec. Use the Studio SDK for production applications; use the AI SDK for AI-inference-only projects or when you want a smaller dependency footprint.

TypeScript

npm install @livepeer/ai

npm: https://www.npmjs.com/package/@livepeer/ai
GitHub: https://github.com/livepeer/livepeer-ai-js
Default gateway: https://dream-gateway.livepeer.cloud (public, non-production)

import Livepeer from '@livepeer/ai';
const client = new Livepeer({ httpBearer: process.env.LIVEPEER_API_KEY });
const result = await client.generate.textToImage({ prompt: 'test' });

Python

pip install livepeer-ai

Go

go get github.com/livepeer/livepeer-ai-go

Deprecated SDKs

Do not use these packages in new projects:

Package	Status	Migration path
`@livepeer/webrtmp-sdk`	Deprecated	Use `@livepeer/react` Broadcast component
`@livepeer/react-native`	Deprecated	Use `react-native-video` (HLS) + `react-native-webrtc` (WebRTC)
Old `livepeer.js` monorepo	Archived	Migrate to `livepeer` npm v3.5.0

SDK Integration Guide

Full code examples, error handling, and retry configuration for all SDKs.

APIs

REST API reference, OpenAPI spec, and endpoint list.

Start Here

Concepts

Get Started

Custom AI Workflows

Guides

Resources

SDK families

Studio SDK

TypeScript / JavaScript

Python

Go

React UI Kit

AI SDK (alpha)

TypeScript

Python

Go

Deprecated SDKs

SDK Integration Guide

APIs

Start Here

Concepts

Get Started

Custom AI Workflows

Guides

Resources

​SDK families

​Studio SDK

​TypeScript / JavaScript

​Python

​Go

​React UI Kit

​AI SDK (alpha)

​TypeScript

​Python

​Go

​Deprecated SDKs

​Related pages

SDK Integration Guide

APIs

SDK families

Studio SDK

TypeScript / JavaScript

Python

Go

React UI Kit

AI SDK (alpha)

TypeScript

Python

Go

Deprecated SDKs

Related pages