Page is under construction.
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Mintlify-compatible OpenAPI (reference-only, derived from gRPC)
⚠️ Documentation reference only
Generated from go-livepeer gRPC messages.
Not a supported public API. Fields may change with protocol upgrades.
openapi: 3.0.3
info:
title: Livepeer Orchestrator Protocol (Reference)
description: >
Derived reference documentation for Gateway ↔ Orchestrator gRPC interfaces.
This spec mirrors protocol messages for operator understanding only.
version: v0-derived
servers:
- url: https://{orchestrator-host}
variables:
orchestrator-host:
default: orchestrator.example.com:8935
paths:
/orchestrator/info:
get:
summary: Get Orchestrator service metadata
description: >
Logical representation of the OrchestratorInfo gRPC message.
Gateways use this data to evaluate pricing, capabilities, and routing.
responses:
'200':
description: OrchestratorInfo
content:
application/json:
schema:
$ref: '#/components/schemas/OrchestratorInfo'
components:
schemas:
OrchestratorInfo:
type: object
required: [transcoder, address, price_info, capabilities]
properties:
transcoder:
type: string
description: Public service URI reachable by Gateways
ticket_params:
$ref: '#/components/schemas/TicketParams'
price_info:
$ref: '#/components/schemas/PriceInfo'
address:
type: string
format: hex
description: ETH payout address
capabilities:
$ref: '#/components/schemas/Capabilities'
auth_token:
$ref: '#/components/schemas/AuthToken'
hardware:
type: array
items:
$ref: '#/components/schemas/HardwareInformation'
storage:
type: array
items:
$ref: '#/components/schemas/OSInfo'
capabilities_prices:
type: array
items:
$ref: '#/components/schemas/PriceInfo'
TicketParams:
type: object
description: Probabilistic payment ticket configuration
PriceInfo:
type: object
properties:
pricePerUnit:
type: integer
description: Cost per pricing unit (Wei)
pixelsPerUnit:
type: integer
description: Pricing granularity unit
Capabilities:
type: object
description: Supported job types and codecs
HardwareInformation:
type: object
description: GPU / CPU / RAM characteristics
OSInfo:
type: object
description: Storage and OS characteristics
AuthToken:
type: object
description: Optional gateway authentication metadata
CLI flags ↔ proto field mapping
| CLI flag | Proto / Message Field | Notes |
|---|
-serviceURI | OrchestratorInfo.transcoder | Public gRPC endpoint |
-pricePerUnit | PriceInfo.pricePerUnit | Base pricing |
-pixelsPerUnit | PriceInfo.pixelsPerUnit | Pricing granularity |
-blockRewardCut | On-chain Orchestrator params | Not part of gRPC |
-feeShare | On-chain Orchestrator params | Delegator economics |
| (implicit) | OrchestratorInfo.address | ETH signer / payout |
| (derived) | capabilities_prices | AI model pricing |
Key point: not everything configurable is gRPC — some is purely on-chain economics.
Capability matrix: Transcoding vs AI jobs
| Capability Area | Transcoding Jobs | AI Jobs |
|---|
| Gateway routing | ✅ | ✅ |
pricePerUnit | ✅ (pixels) | ❌ |
capabilities_prices | ❌ | ✅ (per model) |
| Codec support | ✅ | ❌ |
| Model selection | ❌ | ✅ |
| GPU specs | Optional | Required |
Storage (OSInfo) | Minimal | Important |
| Deterministic pricing | Yes | Often variable |
| Session duration | Stream-based | Job / batch based |
Last modified on February 18, 2026