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_id": "pip_SD-turbo",
  "pipeline_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": 0,
    "t_index_list": [
      0
    ],
    "use_safety_checker": true,
    "width": 0,
    "height": 0,
    "lora_dict": {},
    "use_lcm_lora": true,
    "lcm_lora_id": "<string>",
    "acceleration": "<string>",
    "use_denoising_batch": true,
    "do_add_noise": true,
    "seed": 0,
    "seed_interpolation_method": "linear",
    "enable_similar_image_filter": true,
    "similar_image_filter_threshold": 123,
    "similar_image_filter_max_skip_frame": 0,
    "controlnets": [
      {
        "model_id": "thibaud/controlnet-sd21-openpose-diffusers",
        "conditioning_scale": 123,
        "preprocessor": "<string>",
        "preprocessor_params": {},
        "enabled": true,
        "control_guidance_start": 123,
        "control_guidance_end": 123
      }
    ],
    "ip_adapter": {
      "scale": 123,
      "enabled": true,
      "type": "regular",
      "weight_type": "linear"
    },
    "ip_adapter_style_image_url": "<string>"
  },
  "name": "<string>",
  "output_rtmp_url": "<string>"
}'
{
  "id": "<string>",
  "stream_key": "<string>",
  "output_stream_url": "<string>",
  "pipeline_params": {},
  "created_at": "<string>",
  "pipeline_id": "<string>",
  "output_playback_id": "<string>",
  "name": "<string>",
  "author": "<string>",
  "from_playground": true,
  "gateway_host": "<string>",
  "is_smoke_test": true,
  "whip_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.

Authorizations

Authorization
string
header
required

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

Body

application/json
pipeline_id
enum<string>
default:pip_SD-turbo

ID of the processing pipeline to use for this stream

Available options:
pip_SD-turbo,
pip_SDXL-turbo,
pip_SD15,
pip_SDXL-turbo-faceid
pipeline_params
object

Configuration parameters for the selected pipeline

name
string

Human-readable name for the stream

output_rtmp_url
string

Custom RTMP URL for stream output destination

Response

Default Response

id
string
required

Unique identifier for the stream

stream_key
string
required

Unique key used for streaming to this endpoint

output_stream_url
string
required

URL where the processed stream output can be accessed

pipeline_params
object
required

Current configuration parameters for the stream pipeline

created_at
string
required

ISO timestamp when the stream was created

pipeline_id
string
required

ID of the processing pipeline being used

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