start_live_stream
Allocate the encoder for a live stream.
Required before WebRTC or SRT ingest. Call it before an RTMP publish
too: auto-start works only if a free transcoder is available within
about 15 seconds. Otherwise the stream goes to `stopped` and the
publish is rejected. If the user explicitly asked to start with a
protocol other than this stream's current `input_format`, call
`update_live_stream` on this same id first. Call this tool only if the
stream is not already running. Do not start a different stream instead.
The response
`ingest.host` is the encoder host; SRT and WebRTC URLs are not included.
Already started comes back as `code: live_api_error` (live API 406). Do
not retry that. A 504 is `code: live_timeout`, also a normal result.
Do not retry it either. Call `get_live_stream`: the stream may already
be `stopped`.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"stream_id": "<stream_id>"
},
"name": "start_live_stream"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stream_id | Yes | Live stream id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||