Skip to main content
POST
/
live-video-to-video
Live Video To Video
curl --request POST \
  --url https://dream-gateway.livepeer.cloud/live-video-to-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscribe_url": "<string>",
  "publish_url": "<string>",
  "control_url": "",
  "events_url": "",
  "model_id": "",
  "params": {}
}
'
{
  "subscribe_url": "<string>",
  "publish_url": "<string>",
  "control_url": "",
  "events_url": ""
}
This page is still cooking... Expect big things soon!
Check the github issues for ways to contribute! Or provide your feedback in this quick form

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
subscribe_url
string
required

Source URL of the incoming stream to subscribe to.

​
publish_url
string
required

Destination URL of the outgoing stream to publish.

​
control_url
string
default:""

URL for subscribing via Trickle protocol for updates in the live video-to-video generation params.

​
events_url
string
default:""

URL for publishing events via Trickle protocol for pipeline status and logs.

​
model_id
string
default:""

Name of the pipeline to run in the live video to video job. Notice that this is named model_id for consistency with other routes, but it does not refer to a Hugging Face model ID. The exact model(s) depends on the pipeline implementation and might be configurable via the params argument.

​
params
Params · object

Initial parameters for the pipeline.

Response

Successful Response

Response model for live video-to-video generation.

​
subscribe_url
string
required

Source URL of the incoming stream to subscribe to

​
publish_url
string
required

Destination URL of the outgoing stream to publish to

​
control_url
string
default:""

URL for updating the live video-to-video generation

​
events_url
string
default:""

URL for subscribing to events for pipeline status and logs

Last modified on February 18, 2026