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
| Indicateur de ligne de commande | Proto / Champ de message | Remarques |
|---|
-serviceURI | OrchestratorInfo.transcoder | Point d’extrémité gRPC public |
-pricePerUnit | PriceInfo.pricePerUnit | Tarification de base |
-pixelsPerUnit | PriceInfo.pixelsPerUnit | Granularité de tarification |
-blockRewardCut | Paramètres de l’Orchestrateur sur la chaîne | Pas fait partie de gRPC |
-feeShare | Paramètres de l’Orchestrateur sur la chaîne | Économie des délégués |
| (implicite) | OrchestratorInfo.address | ETH signataire / paiement |
| (dérivé) | capabilities_prices | Tarification des modèles d’IA |
Point clé : rien n’est configurable en gRPC — certaines choses sont une question d’économie sur la chaîne.
Matrice de capacité : Transcodage vs tâches d’IA
| Domaine de capacité | Tâches de transcodage | Tâches d’IA |
|---|
| Acheminement du portail | ✅ | ✅ |
pricePerUnit | ✅ (pixels) | ❌ |
capabilities_prices | ❌ | ✅ (par modèle) |
| Prise en charge du codec | ✅ | ❌ |
| Sélection du modèle | ❌ | ✅ |
| Spécifications GPU | Facultatif | Requis |
Stockage (OSInfo) | Minimal | Important |
| Prix déterministe | Oui | Souvent variable |
| Durée de la session | Basé sur le flux | Travail / basé sur un lot |
Last modified on March 1, 2026