Skip to main content
POST
AcquireVideoStream

Headers

Authorization
string
required

OAuth 2.0 Bearer token with the 'stream' scope. Required for all streaming operations. Format: Bearer <access_token>.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

Accept-Language
string

Preferred locale for error messages and metadata (BCP 47).

Example:

"ar"

Body

application/json

AcquireVideoStreamRequest is the request message for acquiring a video stream. This is the billable event for video playback.

movieId
object

MovieID is a typed identifier for a movie.

episodeId
object

EpisodeID is a typed identifier for an episode.

maxQuality
enum<string>

VideoQuality enumerates the available video stream quality tiers.

Available options:
VIDEO_QUALITY_UNSPECIFIED,
VIDEO_QUALITY_SD,
VIDEO_QUALITY_HD,
VIDEO_QUALITY_FULL_HD,
VIDEO_QUALITY_UHD

Response

Successful response

AcquireVideoStreamResponse is the response message containing the video stream details.

stream
object

StreamInfo contains the information required to play a stream. Returned by all stream acquisition RPCs.