APIs

Reference index for all Livepeer APIs: the Video REST API, the AI gateway inference API, and the go-livepeer node CLI/metrics API.

---

Livepeer Video REST API

The Video REST API covers stream management, VOD asset upload and playback, webhooks, access control, viewership metrics, and transcode jobs. It is the API the Video SDK family (livepeer npm/pip/go/maven packages) wraps.

Base URL: https://livepeer.com/api

Authentication: Bearer token in the Authorization header. API keys are managed in the Livepeer developer dashboard.

OpenAPI spec: The full machine-readable specification is available from the Livepeer developer portal (OpenAPI 3.0).

Key resource groups:

AI Gateway Inference API

The AI inference API is served by the Livepeer gateway for AI workloads. Each pipeline type has a dedicated endpoint. The gateway routes requests to network orchestrators running the ai-runner container.

Base URL: Gateway-dependent. Community gateway: https://dream-gateway.livepeer.cloud. Self-hosted gateways use the configured HTTP address.

Authentication: Bearer token when the gateway requires it; the community gateway accepts unauthenticated requests for development.

OpenAPI spec: Generated from the ai-runner OpenAPI specification. Available at https://docs.livepeer.org/api/ai-worker.yaml.

Pipeline endpoints:

Endpoint	Method	Pipeline
/text-to-image	POST	Text prompt to image
/image-to-image	POST	Image + prompt to transformed image
/image-to-video	POST	Image to short video
/image-to-text	POST	Image to caption
/audio-to-text	POST	Audio to transcript
/text-to-speech	POST	Text to audio
/upscale	POST	Image upscaling
/segment-anything-2	POST	Image segmentation
/llm	POST	OpenAI-compatible chat completions
/live/video-to-video	POST	Real-time AI stream session (trickle)

See for endpoint schemas and curl examples.

Go-Livepeer Node API

go-livepeer nodes expose two local HTTP interfaces: the CLI interface (used by livepeer_cli) and the Prometheus metrics endpoint.

CLI interface: http://<cliAddr>/ (default: http://127.0.0.1:7935/)

Used by livepeer_cli for node management operations: deposit funding, status queries, configuration updates.

Metrics endpoint: http://<cliAddr>/metrics

Exposes Prometheus-format metrics for scraping. Enable with the -metrics flag on node startup. See for the key metric names and monitoring setup.

The node API is local-only by default. Do not expose it externally without access controls.

Related Pages

SDKs

SDK packages that wrap the Video and AI APIs.

AI Pipelines

AI inference API endpoint shapes and request schemas.

Access Control

Access control signing key API for JWT-gated playback.

Viewership

Viewership metrics API for engagement and performance data.