Skip to main content
POST
Create a new stream
This endpoint creates a new video processing stream using the Daydream StreamDiffusion pipeline. You’ll specify the pipeline type and model configuration in the request body.

Request Body Structure

  • pipeline: The processing pipeline to use. Currently "streamdiffusion" is the only public option.
  • params: Configuration object containing the model and generation parameters.
  • params.model_id: The specific model to use (see table below).

Available Models

Which model should I use?
  • SD2.1 (sd-turbo): Fastest, good for real-time effects
  • SDXL (sdxl-turbo): Highest quality, supports IP Adapter for style transfer
  • SD1.5 (dreamshaper-8, openjourney-v4): Great for stylized/cartoon effects, supports IP Adapter and Cached Attention

Example: Create an SDXL Turbo Stream

Example: Create a Stream with ControlNet

For full parameter documentation, see the Parameters section.

Legacy Support

The pipeline_id field (e.g., "pip_SD15") is deprecated but still supported for backward compatibility. New integrations should use pipeline + params.model_id instead.

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