Page is under construction.
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Mintlify-兼容的 OpenAPI(仅参考,源自 gRPC)
⚠️ 文档参考
生成自 go-livepeer gRPC 消息。
不是支持的公共 API。字段可能会随着协议升级而更改。
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 标志 ↔ proto 字段映射
| CLI 标志 | Proto / 消息字段 | 注释 |
|---|
-serviceURI | OrchestratorInfo.transcoder | 公共 gRPC 端点 |
-pricePerUnit | PriceInfo.pricePerUnit | 基础定价 |
-pixelsPerUnit | PriceInfo.pixelsPerUnit | 定价粒度 |
-blockRewardCut | 链上协调器参数 | 不属于 gRPC |
-feeShare | 链上协调器参数 | 委托人经济模型 |
| (隐式) | OrchestratorInfo.address | ETH 签名者 / 支付 |
| (衍生的) | capabilities_prices | AI 模型定价 |
关键点: 并非所有可配置的内容都是 gRPC — 有些是 纯粹的链上经济学.
能力矩阵:转码 vs AI 任务
| 能力领域 | 转码任务 | AI 任务 |
|---|
| 网关路由 | ✅ | ✅ |
pricePerUnit | ✅ (像素) | ❌ |
capabilities_prices | ❌ | ✅ (每个模型) |
| 编解码器支持 | ✅ | ❌ |
| 模型选择 | ❌ | ✅ |
| GPU 规格 | 可选 | 必需 |
存储 (OSInfo) | 最小 | 重要 |
| 确定性定价 | 是 | 通常可变 |
| 会话时长 | 基于流的 | 作业/批次驱动 |
Last modified on March 1, 2026