Skip to main content
POST
/
v1
/
streams
Create a new stream
curl --request POST \
  --url https://api.daydream.live/v1/streams \
  --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
      }
    ]
  },
  "name": "<string>",
  "output_rtmp_url": "<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": 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>"
}
This endpoint allows you to create a new video processing stream that uses a Daydream pipeline. You’ll need to provide a pipeline ID and configuration parameters.
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.

Body

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

Human-readable name for the stream

​
output_rtmp_url
string

Custom RTMP URL for stream output destination

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