Live Streams

Operations related to live streams. A live stream is a single, linear video broadcast. You broadcast a live stream by receiving encoded source video into the Wowza Streaming Cloud service and letting Wowza Streaming Cloud transcode the stream and deliver it to viewers. A live stream is essentially a one-stop method for creating a transcoder, output renditions, stream targets, and associated players.

Ultra low latency stream targets don’t work with live streams. See Get started with ultra low latency streaming using the Wowza Streaming Cloud REST API to learn more.

Create a live stream

This operation creates a live stream.

Request Body schema: application/json

Provide the details of the live stream to create in the body of the request.

live_stream

required

object (live_stream)

aspect_ratio_height required	integer <int32> The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
aspect_ratio_width required	integer <int32> The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
billing_mode required	string Enum: "pay_as_you_go" "twentyfour_seven" The billing mode for the stream. The default is pay_as_you_go.
broadcast_location required	string (broadcast_location) Enum: "asia_pacific_australia" "asia_pacific_india" "asia_pacific_japan" "asia_pacific_singapore" "asia_pacific_s_korea" "asia_pacific_taiwan" "eu_belgium" "eu_germany" "eu_ireland" "south_america_brazil" "us_central_iowa" "us_east_s_carolina" "us_east_virginia" "us_west_california" "us_west_oregon" The location of your stream. Choose a location as close as possible to your video source.
encoder required	string Enum: "wowza_clearcaster" "wowza_gocoder" "wowza_streaming_engine" "media_ds" "axis" "epiphan" "file" "hauppauge" "jvc" "live_u" "matrox" "newtek_tricaster" "osprey" "sony" "telestream_wirecast" "teradek_cube" "vmix" "x_split" "ipcamera" "other_rtmp" "other_rtsp" "other_webrtc" "other_udp" "other_srt" The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp.
name required	string A descriptive name for the live stream. Maximum 200 characters.
transcoder_type required	string Enum: "transcoded" "passthrough" The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded.
closed_caption_type	string Enum: "none" "cea" "on_text" "both" The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided.
delivery_method	string Enum: "pull" "cdn" "push" The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder.
delivery_protocols	Array of strings An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.
delivery_type	string Enum: "single-bitrate" "multi-bitrate" For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud.
disable_authentication	boolean Authentication is required by default for RTMP and RTSP push connections from a video source to Wowza Streaming Cloud. Specify true to disable authentication with the video source.
hosted_page	boolean A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page.
hosted_page_description	string A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_logo_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.
hosted_page_sharing_icons	boolean Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.
hosted_page_title	string A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.
low_latency	boolean For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false. This parameter only affects streams played over a stream target whose type is fastly or wowza. If using a wowza target, the provider must be set to akamai_cupertino. This parameter does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets.
password	string A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used.
player_countdown	boolean A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false.
player_countdown_at	string <date-time> The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC.
player_logo_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller.
player_logo_position	string Enum: "top-left" "top-right" "bottom-left" "bottom-right" The corner of the player in which you want the player logo to appear. The default is top-left.
player_responsive	boolean A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width.
player_type	string The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5.
player_video_poster_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller.
player_width	integer <int32> The width, in pixels, of a fixed-size player. The default is 640.
recording	boolean If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. The default is false.
remove_hosted_page_logo_image	boolean If true, removes the logo file from the hosted page. The default is false.
remove_player_logo_image	boolean If true, removes the logo file from the player. The default is false.
remove_player_video_poster_image	boolean If true, removes the poster image. The default is false.
source_url	string For the delivery_method pull or encoder file. For pull, enter the URL of an IP camera or video encoder using an RTMP and RTSP pull connection to Wowza Streaming Cloud. Consult the camera or encoder documentation for the URL syntax. For file, enter the source file URL, including the protocol (http, https, gs, s3).
target_delivery_protocol	string Value: "hls-https" The type of stream being delivered from Wowza Streaming Cloud. The default and only valid value is hls-https. To send a stream with HDS, use the transcoder workflow with a Wowza stream target that has a provider of akamai.
use_stream_source	boolean If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud.
username	string A user name for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used.
vod_stream	boolean If true, creates a VOD stream after the live stream ends. The default is false.

Responses

201

Success

Response Schema: application/json

live_stream

required

object (live_stream)

aspect_ratio_height	integer <int32> The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
aspect_ratio_width	integer <int32> The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
billing_mode	string Enum: "pay_as_you_go" "twentyfour_seven" The billing mode for the stream. The default is pay_as_you_go.
broadcast_location	string (broadcast_location) Enum: "asia_pacific_australia" "asia_pacific_india" "asia_pacific_japan" "asia_pacific_singapore" "asia_pacific_s_korea" "asia_pacific_taiwan" "eu_belgium" "eu_germany" "eu_ireland" "south_america_brazil" "us_central_iowa" "us_east_s_carolina" "us_east_virginia" "us_west_california" "us_west_oregon" The location of your stream. Choose a location as close as possible to your video source.
closed_caption_type	string Enum: "none" "cea" "on_text" "both" The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided.
connection_code	string A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created.
connection_code_expires_at	string <date-time> The date and time that the connection_code expires.
created_at	string <date-time> The date and time that the live stream was created.
delivery_method	string Enum: "pull" "cdn" "push" The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder.
delivery_protocols	Array of strings An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.
delivery_type	string Enum: "single-bitrate" "multi-bitrate" For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud.
direct_playback_urls	Array of objects (playback_url) An array of direct playback URLs for the live stream's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition.
encoder	string Enum: "wowza_clearcaster" "wowza_gocoder" "wowza_streaming_engine" "media_ds" "axis" "epiphan" "file" "hauppauge" "jvc" "live_u" "matrox" "newtek_tricaster" "osprey" "sony" "telestream_wirecast" "teradek_cube" "vmix" "x_split" "ipcamera" "other_rtmp" "other_rtsp" "other_webrtc" "other_udp" "other_srt" The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp.
hosted_page	boolean A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page.
hosted_page_description	string A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.
hosted_page_sharing_icons	boolean Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.
hosted_page_title	string A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_url	string The URL of the Wowza Streaming Cloud-hosted webpage that viewers can visit to watch the stream.
id	string The unique alphanumeric string that identifies the live stream.
low_latency	boolean For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false. This parameter only affects streams played over a stream target whose type is fastly or wowza. If using a wowza target, the provider must be set to akamai_cupertino. This parameter does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets.
name	string A descriptive name for the live stream. Maximum 200 characters.
player_countdown	boolean A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false.
player_countdown_at	string <date-time> The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC.
player_embed_code	string The HTML code that can be used in an external webpage to host the Wowza Streaming Cloud player.
player_hls_playback_url	string The address that can be used to configure playback of the stream using the HLS protocol.
player_id	string The unique alphanumeric string that identifies the player.
player_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller.
player_logo_position	string Enum: "top-left" "top-right" "bottom-left" "bottom-right" The corner of the player in which you want the player logo to appear. The default is top-left.
player_responsive	boolean A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width.
player_type	string The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5.
player_video_poster_image_url	string The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller.
player_width	integer <int32> The width, in pixels, of a fixed-size player. The default is 640.
recording	boolean If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. The default is false.
source_connection_information	object Details that you can use to manually configure and connect a video source to the live stream.
stream_source_id	string The unique alphanumeric string that identifies the stream source, if a stream source is used.
stream_targets	Array of objects (stream_targets) An array of unique alphanumeric strings that identify the stream targets used by the live stream.
target_delivery_protocol	string Value: "hls-https" The type of stream being delivered from Wowza Streaming Cloud. The default and only valid value is hls-https. To send a stream with HDS, use the transcoder workflow with a Wowza stream target that has a provider of akamai.
transcoder_type	string Enum: "transcoded" "passthrough" The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded.
updated_at	string <date-time> The date and time that the live stream was updated.
use_stream_source	boolean If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud.
vod_stream	boolean If true, creates a VOD stream after the live stream ends. The default is false.

401

Unauthorized

422

Unprocessable Entity

post/live_streams

https://api-sandbox.cloud.wowza.com/api/beta/live_streams

Request samples

Payload
Shell
JavaScript

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"aspect_ratio_height": 1080,
"aspect_ratio_width": 1920,
"billing_mode": "pay_as_you_go",
"broadcast_location": "eu_germany",
"encoder": "wowza_gocoder",
"name": "My Live Stream",
"transcoder_type": "transcoded",
"closed_caption_type": "none",
"delivery_method": "push",
"delivery_protocols": 
["string"
],
"delivery_type": "single-bitrate",
"disable_authentication": false,
"hosted_page": true,
"hosted_page_description": "My Hosted Page Description",
"hosted_page_logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"hosted_page_sharing_icons": true,
"hosted_page_title": "My Hosted Page",
"low_latency": false,
"password": "68332313",
"player_countdown": true,
"player_countdown_at": "2020-02-01T17:00:00.000Z",
"player_logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"player_logo_position": "top-right",
"player_responsive": false,
"player_type": "wowza_player",
"player_video_poster_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"player_width": 640,
"recording": true,
"remove_hosted_page_logo_image": true,
"remove_player_logo_image": true,
"remove_player_video_poster_image": true,
"source_url": "xyz.streamlock.net/vod/mp4:Movie.mov",
"target_delivery_protocol": "hls-https",
"use_stream_source": false,
"username": "client2",
"vod_stream": true
}
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"aspect_ratio_height": 1080,
"aspect_ratio_width": 1920,
"billing_mode": "pay_as_you_go",
"broadcast_location": "us_west_california",
"closed_caption_type": "cea",
"connection_code": "0e15cb",
"connection_code_expires_at": "2020-11-30T17:16:21.956Z",
"created_at": "2020-01-29T17:16:21.956Z",
"delivery_method": "push",
"delivery_protocols": 
["rtmp",
"rtsp",
"wowz"
],
"delivery_type": "multi-bitrate",
"direct_playback_urls": 
[
{"rtmp": 
[
{"name": "source",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream6"
}
]
},
{"rtsp": 
[
{"name": "source",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
},
{"wowz": 
[
{"name": "source",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
}
],
"encoder": "wowza_streaming_engine",
"hosted_page": true,
"hosted_page_description": "My Hosted Page Description",
"hosted_page_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg",
"hosted_page_sharing_icons": true,
"hosted_page_title": "My Hosted Page",
"hosted_page_url": "https://player.cloud.wowza.com/hosted/e8dk5bf6/player.html",
"id": "wdjfqvsv",
"name": "My PAYG Transcoded WSE Live Stream",
"player_countdown": true,
"player_countdown_at": "2020-02-01T17:00:00.000Z",
"player_embed_code": null,
"player_hls_playback_url": "https://[wowzasubdomain].wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8",
"player_id": "kwb6pwnv",
"player_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/logo_image/23424/5bad28.jpg",
"player_logo_position": "top-right",
"player_responsive": false,
"player_type": "original_html5",
"player_video_poster_image_url": "https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg",
"player_width": 640,
"recording": true,
"stream_source_id": "5skrfpyf",
"stream_targets": 
[
{"id": "klbmg2h8"
},
{"id": "bnjtdmmc"
}
],
"target_delivery_protocol": "hls-https",
"transcoder_type": "transcoded",
"updated_at": "2020-01-31T06:12:39.956Z",
"use_stream_source": true,
"vod_stream": true
}
}

Fetch all live streams

This operation shows limited details for all of your live streams. For detailed information, fetch a single live stream.

query Parameters

page	integer Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Streaming Cloud REST API.
per_page	integer For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000.

Responses

200

Success

Response Schema: application/json

live_streams

required

Array of objects (live_streams)

Array

created_at	string <date-time> The date and time that the live stream was created.
id	string The unique alphanumeric string that identifies the live stream.
name	string A descriptive name for the live stream. Maximum 200 characters.
updated_at	string <date-time> The date and time that the live stream was updated.

401

Unauthorized

get/live_streams

https://api-sandbox.cloud.wowza.com/api/beta/live_streams

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WSC_HOST}/api/beta/live_streams"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_streams": 
[
{"id": "wdjfqvsv",
"name": "My PAYG Transcoded WSE Live Stream",
"created_at": "2020-01-29T17:16:21.849Z",
"updated_at": "2020-01-31T16:06:47.849Z"
},
{"id": "KyxWKtHQ",
"name": "My 24x7 Passthrough GoCoder Live Stream",
"created_at": "2020-01-29T17:16:21.849Z",
"updated_at": "2020-01-31T02:26:05.849Z"
},
{"id": "Ly40ZDSg",
"name": "My PAYG Transcoded Teradek Cube Live Stream",
"created_at": "2020-01-29T17:16:21.849Z",
"updated_at": "2020-01-30T18:13:18.849Z"
}
]
}

Fetch a live stream

This operation shows the details of a specific live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

aspect_ratio_height	integer <int32> The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
aspect_ratio_width	integer <int32> The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
billing_mode	string Enum: "pay_as_you_go" "twentyfour_seven" The billing mode for the stream. The default is pay_as_you_go.
broadcast_location	string (broadcast_location) Enum: "asia_pacific_australia" "asia_pacific_india" "asia_pacific_japan" "asia_pacific_singapore" "asia_pacific_s_korea" "asia_pacific_taiwan" "eu_belgium" "eu_germany" "eu_ireland" "south_america_brazil" "us_central_iowa" "us_east_s_carolina" "us_east_virginia" "us_west_california" "us_west_oregon" The location of your stream. Choose a location as close as possible to your video source.
closed_caption_type	string Enum: "none" "cea" "on_text" "both" The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided.
connection_code	string A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created.
connection_code_expires_at	string <date-time> The date and time that the connection_code expires.
created_at	string <date-time> The date and time that the live stream was created.
delivery_method	string Enum: "pull" "cdn" "push" The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder.
delivery_protocols	Array of strings An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.
delivery_type	string Enum: "single-bitrate" "multi-bitrate" For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud.
direct_playback_urls	Array of objects (playback_url) An array of direct playback URLs for the live stream's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition.
encoder	string Enum: "wowza_clearcaster" "wowza_gocoder" "wowza_streaming_engine" "media_ds" "axis" "epiphan" "file" "hauppauge" "jvc" "live_u" "matrox" "newtek_tricaster" "osprey" "sony" "telestream_wirecast" "teradek_cube" "vmix" "x_split" "ipcamera" "other_rtmp" "other_rtsp" "other_webrtc" "other_udp" "other_srt" The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp.
hosted_page	boolean A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page.
hosted_page_description	string A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.
hosted_page_sharing_icons	boolean Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.
hosted_page_title	string A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_url	string The URL of the Wowza Streaming Cloud-hosted webpage that viewers can visit to watch the stream.
id	string The unique alphanumeric string that identifies the live stream.
low_latency	boolean For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false. This parameter only affects streams played over a stream target whose type is fastly or wowza. If using a wowza target, the provider must be set to akamai_cupertino. This parameter does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets.
name	string A descriptive name for the live stream. Maximum 200 characters.
player_countdown	boolean A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false.
player_countdown_at	string <date-time> The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC.
player_embed_code	string The HTML code that can be used in an external webpage to host the Wowza Streaming Cloud player.
player_hls_playback_url	string The address that can be used to configure playback of the stream using the HLS protocol.
player_id	string The unique alphanumeric string that identifies the player.
player_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller.
player_logo_position	string Enum: "top-left" "top-right" "bottom-left" "bottom-right" The corner of the player in which you want the player logo to appear. The default is top-left.
player_responsive	boolean A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width.
player_type	string The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5.
player_video_poster_image_url	string The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller.
player_width	integer <int32> The width, in pixels, of a fixed-size player. The default is 640.
recording	boolean If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. The default is false.
source_connection_information	object Details that you can use to manually configure and connect a video source to the live stream.
stream_source_id	string The unique alphanumeric string that identifies the stream source, if a stream source is used.
stream_targets	Array of objects (stream_targets) An array of unique alphanumeric strings that identify the stream targets used by the live stream.
target_delivery_protocol	string Value: "hls-https" The type of stream being delivered from Wowza Streaming Cloud. The default and only valid value is hls-https. To send a stream with HDS, use the transcoder workflow with a Wowza stream target that has a provider of akamai.
transcoder_type	string Enum: "transcoded" "passthrough" The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded.
updated_at	string <date-time> The date and time that the live stream was updated.
use_stream_source	boolean If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud.
vod_stream	boolean If true, creates a VOD stream after the live stream ends. The default is false.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

get/live_streams/{id}

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"aspect_ratio_height": 1080,
"aspect_ratio_width": 1920,
"billing_mode": "pay_as_you_go",
"broadcast_location": "us_west_california",
"closed_caption_type": "cea",
"connection_code": "0e15cb",
"connection_code_expires_at": "2020-11-30T17:16:21.956Z",
"created_at": "2020-01-29T17:16:21.956Z",
"delivery_method": "push",
"delivery_protocols": 
["rtmp",
"rtsp",
"wowz"
],
"delivery_type": "multi-bitrate",
"direct_playback_urls": 
[
{"rtmp": 
[
{"name": "source",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream6"
}
]
},
{"rtsp": 
[
{"name": "source",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
},
{"wowz": 
[
{"name": "source",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
}
],
"encoder": "wowza_streaming_engine",
"hosted_page": true,
"hosted_page_description": "My Hosted Page Description",
"hosted_page_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg",
"hosted_page_sharing_icons": true,
"hosted_page_title": "My Hosted Page",
"hosted_page_url": "https://player.cloud.wowza.com/hosted/e8dk5bf6/player.html",
"id": "wdjfqvsv",
"name": "My PAYG Transcoded WSE Live Stream",
"player_countdown": true,
"player_countdown_at": "2020-02-01T17:00:00.000Z",
"player_embed_code": null,
"player_hls_playback_url": "https://[wowzasubdomain].wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8",
"player_id": "kwb6pwnv",
"player_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/logo_image/23424/5bad28.jpg",
"player_logo_position": "top-right",
"player_responsive": false,
"player_type": "original_html5",
"player_video_poster_image_url": "https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg",
"player_width": 640,
"recording": true,
"stream_source_id": "5skrfpyf",
"stream_targets": 
[
{"id": "klbmg2h8"
},
{"id": "bnjtdmmc"
}
],
"target_delivery_protocol": "hls-https",
"transcoder_type": "transcoded",
"updated_at": "2020-01-31T06:12:39.956Z",
"use_stream_source": true,
"vod_stream": true
}
}

Update a live stream

This operation updates a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Request Body schema: application/json

Provide the details of the live stream to update in the body of the request.

live_stream

required

object (live_stream)

aspect_ratio_height required	integer <int32> The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
aspect_ratio_width required	integer <int32> The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
encoder required	string Enum: "wowza_clearcaster" "wowza_gocoder" "wowza_streaming_engine" "media_ds" "axis" "epiphan" "file" "hauppauge" "jvc" "live_u" "matrox" "newtek_tricaster" "osprey" "sony" "telestream_wirecast" "teradek_cube" "vmix" "x_split" "ipcamera" "other_rtmp" "other_rtsp" "other_webrtc" "other_udp" "other_srt" The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp.
name required	string A descriptive name for the live stream. Maximum 200 characters.
closed_caption_type	string Enum: "none" "cea" "on_text" "both" The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided.
delivery_method	string Enum: "pull" "cdn" "push" The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder.
delivery_protocols	Array of strings An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.
disable_authentication	boolean Authentication is required by default for RTMP and RTSP push connections from a video source to Wowza Streaming Cloud. Specify true to disable authentication with the video source.
hosted_page_description	string A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_logo_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.
hosted_page_sharing_icons	boolean Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.
hosted_page_title	string A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.
password	string A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used.
player_countdown	boolean A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false.
player_countdown_at	string <date-time> The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC.
player_logo_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller.
player_logo_position	string Enum: "top-left" "top-right" "bottom-left" "bottom-right" The corner of the player in which you want the player logo to appear. The default is top-left.
player_responsive	boolean A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width.
player_type	string The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5.
player_video_poster_image	string A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller.
player_width	integer <int32> The width, in pixels, of a fixed-size player. The default is 640.
recording	boolean If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. The default is false.
remove_hosted_page_logo_image	boolean If true, removes the logo file from the hosted page. The default is false.
remove_player_logo_image	boolean If true, removes the logo file from the player. The default is false.
remove_player_video_poster_image	boolean If true, removes the poster image. The default is false.
source_url	string For the delivery_method pull or encoder file. For pull, enter the URL of an IP camera or video encoder using an RTMP and RTSP pull connection to Wowza Streaming Cloud. Consult the camera or encoder documentation for the URL syntax. For file, enter the source file URL, including the protocol (http, https, gs, s3).
target_delivery_protocol	string Value: "hls-https" The type of stream being delivered from Wowza Streaming Cloud. The default and only valid value is hls-https. To send a stream with HDS, use the transcoder workflow with a Wowza stream target that has a provider of akamai.
use_stream_source	boolean If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud.
username	string A user name for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used.
vod_stream	boolean If true, creates a VOD stream after the live stream ends. The default is false.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

aspect_ratio_height	integer <int32> The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
aspect_ratio_width	integer <int32> The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8.
billing_mode	string Enum: "pay_as_you_go" "twentyfour_seven" The billing mode for the stream. The default is pay_as_you_go.
broadcast_location	string (broadcast_location) Enum: "asia_pacific_australia" "asia_pacific_india" "asia_pacific_japan" "asia_pacific_singapore" "asia_pacific_s_korea" "asia_pacific_taiwan" "eu_belgium" "eu_germany" "eu_ireland" "south_america_brazil" "us_central_iowa" "us_east_s_carolina" "us_east_virginia" "us_west_california" "us_west_oregon" The location of your stream. Choose a location as close as possible to your video source.
closed_caption_type	string Enum: "none" "cea" "on_text" "both" The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided.
connection_code	string A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created.
connection_code_expires_at	string <date-time> The date and time that the connection_code expires.
created_at	string <date-time> The date and time that the live stream was created.
delivery_method	string Enum: "pull" "cdn" "push" The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder.
delivery_protocols	Array of strings An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.
delivery_type	string Enum: "single-bitrate" "multi-bitrate" For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud.
direct_playback_urls	Array of objects (playback_url) An array of direct playback URLs for the live stream's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition.
encoder	string Enum: "wowza_clearcaster" "wowza_gocoder" "wowza_streaming_engine" "media_ds" "axis" "epiphan" "file" "hauppauge" "jvc" "live_u" "matrox" "newtek_tricaster" "osprey" "sony" "telestream_wirecast" "teradek_cube" "vmix" "x_split" "ipcamera" "other_rtmp" "other_rtsp" "other_webrtc" "other_udp" "other_srt" The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp.
hosted_page	boolean A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page.
hosted_page_description	string A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller.
hosted_page_sharing_icons	boolean Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons.
hosted_page_title	string A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags.
hosted_page_url	string The URL of the Wowza Streaming Cloud-hosted webpage that viewers can visit to watch the stream.
id	string The unique alphanumeric string that identifies the live stream.
low_latency	boolean For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false. This parameter only affects streams played over a stream target whose type is fastly or wowza. If using a wowza target, the provider must be set to akamai_cupertino. This parameter does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets.
name	string A descriptive name for the live stream. Maximum 200 characters.
player_countdown	boolean A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false.
player_countdown_at	string <date-time> The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC.
player_embed_code	string The HTML code that can be used in an external webpage to host the Wowza Streaming Cloud player.
player_hls_playback_url	string The address that can be used to configure playback of the stream using the HLS protocol.
player_id	string The unique alphanumeric string that identifies the player.
player_logo_image_url	string The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller.
player_logo_position	string Enum: "top-left" "top-right" "bottom-left" "bottom-right" The corner of the player in which you want the player logo to appear. The default is top-left.
player_responsive	boolean A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width.
player_type	string The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5.
player_video_poster_image_url	string The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller.
player_width	integer <int32> The width, in pixels, of a fixed-size player. The default is 640.
recording	boolean If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. The default is false.
source_connection_information	object Details that you can use to manually configure and connect a video source to the live stream.
stream_source_id	string The unique alphanumeric string that identifies the stream source, if a stream source is used.
stream_targets	Array of objects (stream_targets) An array of unique alphanumeric strings that identify the stream targets used by the live stream.
target_delivery_protocol	string Value: "hls-https" The type of stream being delivered from Wowza Streaming Cloud. The default and only valid value is hls-https. To send a stream with HDS, use the transcoder workflow with a Wowza stream target that has a provider of akamai.
transcoder_type	string Enum: "transcoded" "passthrough" The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded.
updated_at	string <date-time> The date and time that the live stream was updated.
use_stream_source	boolean If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud.
vod_stream	boolean If true, creates a VOD stream after the live stream ends. The default is false.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

patch/live_streams/{id}

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}

Request samples

Payload
Shell
JavaScript

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"aspect_ratio_height": 1080,
"aspect_ratio_width": 1920,
"encoder": "wowza_gocoder",
"name": "My Live Stream",
"closed_caption_type": "cea",
"delivery_method": "push",
"delivery_protocols": 
["string"
],
"disable_authentication": false,
"hosted_page_description": "My Hosted Page Description",
"hosted_page_logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"hosted_page_sharing_icons": true,
"hosted_page_title": "My Hosted Page",
"password": "68332313",
"player_countdown": true,
"player_countdown_at": "2020-02-01T17:00:00.000Z",
"player_logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"player_logo_position": "top-right",
"player_responsive": false,
"player_type": "wowza_player",
"player_video_poster_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]",
"player_width": 640,
"recording": true,
"remove_hosted_page_logo_image": true,
"remove_player_logo_image": true,
"remove_player_video_poster_image": true,
"source_url": "xyz.streamlock.net/vod/mp4:Movie.mov",
"target_delivery_protocol": "hls-https",
"use_stream_source": false,
"username": "client2",
"vod_stream": true
}
}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"aspect_ratio_height": 1080,
"aspect_ratio_width": 1920,
"billing_mode": "pay_as_you_go",
"broadcast_location": "us_west_california",
"closed_caption_type": "cea",
"connection_code": "0e15cb",
"connection_code_expires_at": "2020-11-30T17:16:21.956Z",
"created_at": "2020-01-29T17:16:21.956Z",
"delivery_method": "push",
"delivery_protocols": 
["rtmp",
"rtsp",
"wowz"
],
"delivery_type": "multi-bitrate",
"direct_playback_urls": 
[
{"rtmp": 
[
{"name": "source",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtmp://abc123.entrypoint.cloud.wowza.com/app-51eb/wxyz6789_stream6"
}
]
},
{"rtsp": 
[
{"name": "source",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "rtsp://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
},
{"wowz": 
[
{"name": "source",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789"
},
{"name": "1920x1080",
"output_id": "dcxq5q6c",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream1"
},
{"name": "1280x720",
"output_id": "0g116zkf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream2"
},
{"name": "854x480",
"output_id": "4qqkwndt",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream3"
},
{"name": "640x360",
"output_id": "0pv8djpg",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream4"
},
{"name": "512x288",
"output_id": "b09xrxjf",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream5"
},
{"name": "320x180",
"output_id": "bvkh2nsz",
"url": "wowz://abc123.entrypoint.cloud.wowza.com:1935/app-51eb/wxyz6789_stream6"
}
]
}
],
"encoder": "wowza_streaming_engine",
"hosted_page": true,
"hosted_page_description": "My Hosted Page Description",
"hosted_page_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg",
"hosted_page_sharing_icons": true,
"hosted_page_title": "My Hosted Page",
"hosted_page_url": "https://player.cloud.wowza.com/hosted/e8dk5bf6/player.html",
"id": "wdjfqvsv",
"name": "My PAYG Transcoded WSE Live Stream",
"player_countdown": true,
"player_countdown_at": "2020-02-01T17:00:00.000Z",
"player_embed_code": null,
"player_hls_playback_url": "https://[wowzasubdomain].wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8",
"player_id": "kwb6pwnv",
"player_logo_image_url": "https://prod.s3.amazonaws.com/uploads/player/logo_image/23424/5bad28.jpg",
"player_logo_position": "top-right",
"player_responsive": false,
"player_type": "original_html5",
"player_video_poster_image_url": "https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg",
"player_width": 640,
"recording": true,
"stream_source_id": "5skrfpyf",
"stream_targets": 
[
{"id": "klbmg2h8"
},
{"id": "bnjtdmmc"
}
],
"target_delivery_protocol": "hls-https",
"transcoder_type": "transcoded",
"updated_at": "2020-01-31T06:12:39.956Z",
"use_stream_source": true,
"vod_stream": true
}
}

Delete a live stream

This operation deletes a live stream, including all assigned outputs and targets.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

204

No Content

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

delete/live_streams/{id}

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "DELETE" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"Example Response 1": 
{"meta": 
{"status": 401,
"code": "ERR-401-NoApiKey",
"title": "No API Key Error",
"message": "No API key sent in header.",
"description": "",
"links": [ ]
}
},
"Example Response 2": 
{"meta": 
{"status": 401,
"code": "ERR-401-NoAccessKey",
"title": "No Access Key Error",
"message": "No access key sent in header.",
"description": "",
"links": [ ]
}
},
"Example Response 3": 
{"meta": 
{"status": 401,
"code": "ERR-401-InvalidApiKey",
"title": "Invalid Api Key Error",
"message": "Invalid API key.",
"description": "",
"links": [ ]
}
},
"Example Response 4": 
{"meta": 
{"status": 401,
"code": "ERR-401-InvalidAccessKey",
"title": "Invalid Access Key Error",
"message": "Invalid access key.",
"description": "",
"links": [ ]
}
},
"Example Response 5": 
{"meta": 
{"status": 401,
"code": "ERR-401-BadAccountStatus",
"title": "Bad Account Status Error",
"message": "Your account's status doesn't allow this action.",
"description": "",
"links": [ ]
}
},
"Example Response 6": 
{"meta": 
{"status": 401,
"code": "ERR-401-FeatureNotEnabled",
"title": "Feature Not Enabled Error",
"message": "This feature isn't enabled.",
"description": "",
"links": [ ]
}
},
"Example Response 7": 
{"meta": 
{"status": 401,
"code": "ERR-401-TrialExceeded",
"title": "Bad Billing Status Error",
"message": "Your billing status needs attention. You can't start or add live streams until your billing status is updated.",
"description": "",
"links": [ ]
}
}
}

Start a live stream

This operation starts a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

state

string

Enum: "started" "stopped" "starting" "stopping" "resetting"

The state of the live stream.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

put/live_streams/{id}/start

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/start

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "PUT" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/start"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"state": "starting"
}
}

Stop a live stream

This operation stops a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

state

string

Enum: "started" "stopped" "starting" "stopping" "resetting"

The state of the live stream.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

put/live_streams/{id}/stop

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/stop

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "PUT" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/stop"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"state": "stopped"
}
}

Reset a live stream

This operation resets a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

state

string

Enum: "started" "stopped" "starting" "stopping" "resetting"

The state of the live stream.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

put/live_streams/{id}/reset

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/reset

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "PUT" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/reset"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"state": "resetting"
}
}

Regenerate the connection code for a live stream

This operation regenerates the connection code of a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

connection_code

string

A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

put/live_streams/{id}/regenerate_connection_code

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/regenerate_connection_code

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "PUT" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/regenerate_connection_code"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"connection_code": "0cd2e8"
}
}

Fetch the thumbnail URL of a live stream

This operation shows the thumbnail URL of a started live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

thumbnail_url

string

The URL to receive the preview thumbnail.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

get/live_streams/{id}/thumbnail_url

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/thumbnail_url

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/thumbnail_url"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"thumbnail_url": "https://cloud.wowza.com/proxy/stats/?target=10.11.12.13&app=app-79b8&stream=99b62146@130135.stream&media=json"
}
}

Fetch the state of a live stream

This operation shows the current state of a live stream.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (live_stream)

ip_address	string The IP address of the live stream instance. If the live stream state is anything other than started, the ip_address is 0.0.0.0.
state	string Enum: "started" "stopped" "starting" "stopping" "resetting" The state of the live stream.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

get/live_streams/{id}/state

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/state

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/state"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"ip_address": "0.0.0.0",
"state": "stopped"
}
}

Fetch metrics for an active live stream

This operation returns a hash of metrics keys, each of which identifies a status, text description, unit, and value.

path Parameters

required

string

The unique alphanumeric string that identifies the live stream.

Responses

200

Success

Response Schema: application/json

live_stream

required

object (shm_metrics)

audio_codec	object (audio_codec_metric)
bits_in_rate	object (bits_in_rate_metric)
bits_out_rate	object (bits_out_rate_metric)
bytes_in_rate	object (bytes_in_rate_metric)
bytes_out_rate	object (bytes_out_rate_metric)
configured_bytes_out_rate	object (configured_bytes_out_rate_metric)
connected	object (connected_metric)
frame_size	object (frame_size_metric)
frame_rate	object (frame_rate_metric)
height	object (height_metric)
keyframe_interval	object (keyframe_interval_metric)
stream_target_status_OUTPUTIDX_STREAMTARGETIDX	object (stream_target_status_OUTPUTIDX_STREAMTARGETIDX_metric)
unique_views	object (unique_views_metric) The number of unique viewers in the last 5 minutes. Note: This parameter only returns data for Fastly stream targets.
video_codec	object (video_codec_metric)
width	object (width_metric)

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

get/live_streams/{id}/stats

https://api-sandbox.cloud.wowza.com/api/beta/live_streams/{id}/stats

Request samples

Shell
JavaScript

Copy

// Using cURL
curl -H "wsc-api-key: ${WSC_API_KEY}" \
  -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WSC_HOST}/api/beta/live_streams/2adffc17/stats"

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"live_stream": 
{"audio_codec": 
{"status": "normal",
"text": "",
"units": "",
"value": "aac"
},
"bits_in_rate": 
{"status": "normal",
"text": "",
"units": "Kbps",
"value": 317.3
},
"bits_out_rate": 
{"status": "normal",
"text": "",
"units": "Kbps",
"value": 856
},
"bytes_in_rate": 
{"status": "normal",
"text": "",
"units": "KBps",
"value": 317.3
},
"bytes_out_rate": 
{"status": "normal",
"text": "",
"units": "KBps",
"value": 856
},
"configured_bytes_out_rate": 
{"status": "warning",
"text": "Outbound bitrate is lower than the configured bitrate. There might be a problem with the stream targets.",
"units": "Kbps",
"value": 8192
},
"connected": 
{"status": "normal",
"text": "",
"units": "",
"value": "Yes"
},
"frame_size": 
{"status": "warning",
"text": "Configured frame size is different from what Wowza Streaming Cloud is receiving from the source: 1280x720.",
"units": "",
"value": "1280x720"
},
"frame_rate": 
{"status": "normal",
"text": "",
"units": "FPS",
"value": 30
},
"height": 
{"status": "warning",
"text": "Configured height is different from what Wowza Streaming Cloud is receiving from the source: 720.",
"units": "px",
"value": 720
},
"keyframe_interval": 
{"status": "normal",
"text": "",
"units": "GOP",
"value": 69
},
"stream_target_status_OUTPUTIDX_STREAMTARGETIDX": 
{"status": "normal",
"text": "",
"units": "",
"value": "Active"
},
"unique_views": 
{"status": "normal",
"text": "",
"units": "%",
"value": 1030
},
"video_codec": 
{"status": "normal",
"text": "",
"units": "",
"value": "avc1"
},
"width": 
{"status": "warning",
"text": "Configured width is different from what Wowza Streaming Cloud is receiving from the source: 1280.",
"units": "px",
"value": 1280
}
}
}

➔ Next to Players