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 '
{
  "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": 50,
    "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,
    "skip_diffusion": true,
    "image_preprocessing": {
      "processors": [
        {
          "type": "blur",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "image_postprocessing": {
      "processors": [
        {
          "type": "blur",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "latent_preprocessing": {
      "processors": [
        {
          "type": "latent_feedback",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "latent_postprocessing": {
      "processors": [
        {
          "type": "latent_feedback",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "controlnets": [
      {
        "model_id": "thibaud/controlnet-sd21-openpose-diffusers",
        "conditioning_scale": 0.5,
        "preprocessor": "blur",
        "enabled": true,
        "preprocessor_params": {},
        "control_guidance_start": 0.5,
        "control_guidance_end": 0.5
      }
    ]
  }
}
'
{
  "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": 50,
    "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,
    "skip_diffusion": true,
    "image_preprocessing": {
      "processors": [
        {
          "type": "blur",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "image_postprocessing": {
      "processors": [
        {
          "type": "blur",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "latent_preprocessing": {
      "processors": [
        {
          "type": "latent_feedback",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "latent_postprocessing": {
      "processors": [
        {
          "type": "latent_feedback",
          "enabled": true,
          "params": {}
        }
      ],
      "enabled": true
    },
    "controlnets": [
      {
        "model_id": "thibaud/controlnet-sd21-openpose-diffusers",
        "conditioning_scale": 0.5,
        "preprocessor": "blur",
        "enabled": true,
        "preprocessor_params": {},
        "control_guidance_start": 0.5,
        "control_guidance_end": 0.5
      }
    ]
  },
  "id": "<string>",
  "stream_key": "<string>",
  "created_at": "<string>",
  "output_playback_id": "<string>",
  "name": "<string>",
  "author": "<string>",
  "from_playground": true,
  "gateway_host": "<string>",
  "is_smoke_test": true,
  "whip_url": "<string>",
  "output_stream_url": "<string>"
}
Rate limit: 300 requests per minute.
This endpoint allows you to update pipeline parameters for an existing stream. You can modify prompts, ControlNet settings, IP Adapter configuration, and other generation parameters.

​
Request Body Structure

{
  "pipeline": "streamdiffusion",
  "params": {
    "model_id": "Lykon/dreamshaper-8",
    "prompt": "new prompt",
    // ... only include parameters you want to change
  }
}
The pipeline field defaults to "streamdiffusion" if omitted, so you can just send params for most updates.

​
Hot-Swap vs Reload Parameters

The following parameters can be updated dynamically (no reload required):
  • prompt, negative_prompt
  • guidance_scale, delta
  • num_inference_steps, t_index_list
  • seed
  • controlnets.conditioning_scale
  • ip_adapter settings
  • ip_adapter_style_image_url
All other parameters trigger a full pipeline reload (~30s).

​
Example: Update Prompt

curl -X PATCH \
  "https://api.daydream.live/v1/streams/${STREAM_ID}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DAYDREAM_API_KEY}" \
  -d '{
    "params": {
      "model_id": "Lykon/dreamshaper-8",
      "prompt": "cyberpunk cityscape, neon lights"
    }
  }'

​
Example: Adjust ControlNet Strength

curl -X PATCH \
  "https://api.daydream.live/v1/streams/${STREAM_ID}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${DAYDREAM_API_KEY}" \
  -d '{
    "params": {
      "model_id": "Lykon/dreamshaper-8",
      "controlnets": [
        {
          "model_id": "lllyasviel/control_v11f1p_sd15_depth",
          "preprocessor": "depth_tensorrt",
          "conditioning_scale": 0.7,
          "enabled": true
        }
      ]
    }
  }'
For full parameter documentation, see the Parameters section.

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 string length: 1

Body

application/json
​
pipeline
enum<string>
required
Available options:
streamdiffusion
​
params
SDTurbo · object
required

Response

Default Response

​
pipeline
enum<string>
required
Available options:
streamdiffusion
​
params
SDTurbo · object
required
​
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