Skip to main content
PATCH
/
v1
/
streams
/
{id}
Update a stream
curl --request PATCH \
  --url https://api.daydream.live/v1/streams/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "params": {},
  "prompt": "<string>"
}'
{
  "pipeline": "streamdiffusion",
  "params": {
    "model_id": "stabilityai/sd-turbo",
    "prompt": "<string>",
    "prompt_interpolation_method": "linear",
    "normalize_prompt_weights": true,
    "normalize_seed_weights": true,
    "negative_prompt": "<string>",
    "guidance_scale": 123,
    "delta": 123,
    "num_inference_steps": 100,
    "t_index_list": [
      0
    ],
    "use_safety_checker": true,
    "width": 704,
    "height": 704,
    "lora_dict": {},
    "use_lcm_lora": true,
    "lcm_lora_id": "<string>",
    "acceleration": "none",
    "use_denoising_batch": true,
    "do_add_noise": true,
    "seed": 0,
    "seed_interpolation_method": "linear",
    "enable_similar_image_filter": true,
    "similar_image_filter_threshold": 0.5,
    "similar_image_filter_max_skip_frame": 4503599627370495,
    "controlnets": [
      {
        "model_id": "thibaud/controlnet-sd21-openpose-diffusers",
        "conditioning_scale": 0.5,
        "preprocessor": "pose_tensorrt",
        "preprocessor_params": {},
        "enabled": true,
        "control_guidance_start": 0.5,
        "control_guidance_end": 0.5
      }
    ]
  },
  "id": "<string>",
  "stream_key": "<string>",
  "output_stream_url": "<string>",
  "pipeline_id": "<string>",
  "pipeline_params": {},
  "created_at": "<string>",
  "output_playback_id": "<string>",
  "name": "<string>",
  "author": "<string>",
  "from_playground": true,
  "gateway_host": "<string>",
  "is_smoke_test": true,
  "whip_url": "<string>"
}
This is the preferred method for updating streams. It replaces the deprecated Submit StreamDiffusion Prompt endpoint and only requires the parameters you want to change.
This endpoint allows you to update pipeline parameters or prompts for an existing video processing stream with advanced parameters including controlnets, lora settings, and other configurations specifically designed for TouchDesigner integration.
The following parameters can be updated dynamically (no reload required): prompt, guidance_scale, delta, num_inference_steps, t_index_list, seed, controlnets.conditioning_scale. All other parameters trigger a full pipeline reload (~30s).
When specifying the pipeline_id, it also needs to match the right model_id.Ex. pip_SD-turbo corresponds to stabilityai/sd-turbo

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

ID of the stream to update

Minimum length: 1

Body

application/json
​
params
object

Updated pipeline parameters for the stream

​
prompt
string

Updated prompt to apply to the stream processing

Response

Default Response

​
pipeline
enum<string>
required
Available options:
streamdiffusion
​
params
object
required
  • SDTurbo
  • SDXL
  • SD1.5
​
id
string
required

Unique identifier for the stream

​
stream_key
string
required

Unique key used for streaming to this endpoint

​
created_at
string
required

ISO timestamp when the stream was created

​
output_playback_id
string
required

Playback ID for accessing the stream output

​
name
string
required

Human-readable name of the stream

​
author
string
required

ID of the user who created this stream

​
from_playground
boolean
required

Whether this stream was created from the playground interface

​
gateway_host
string
required

Gateway server hostname handling this stream

​
is_smoke_test
boolean
required

Whether this is a smoke test stream

​
whip_url
string
required

WebRTC WHIP URL for stream ingestion

​
output_stream_url
string

URL where the processed stream output can be accessed

​
pipeline_id
string | null

Deprecated: use pipeline instead. ID of the processing pipeline being used

​
pipeline_params
object

Deprecated: use params instead. Current configuration parameters for the stream pipeline