gcore 0.6.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

gcore/types/streaming/stream.py

@@ -0,0 +1,420 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .streams.overlay import Overlay
+
+__all__ = ["Stream"]
+
+
+class Stream(BaseModel):
+    name: str
+    """
+    Stream name. Often used as a human-readable name for the stream, but can contain
+    any text you wish. The values are not unique and may be repeated. Examples:
+
+    - Conference in July
+    - Stream #10003
+    - Open-Air Camera #31 Backstage
+    - 480fd499-2de2-4988-bc1a-a4eebe9818ee
+    """
+
+    id: Optional[int] = None
+    """Stream ID"""
+
+    active: Optional[bool] = None
+    """Stream switch between on and off.
+
+    This is not an indicator of the status "stream is receiving and it is LIVE", but
+    rather an on/off switch. When stream is switched off, there is no way to process
+    it: PULL is deactivated and PUSH will return an error.
+
+    - true – stream can be processed
+    - false – stream is off, and cannot be processed
+    """
+
+    auto_record: Optional[bool] = None
+    """Enables autotomatic recording of the stream when it started.
+
+    So you don't need to call recording manually. Result of recording is
+    automatically added to video hosting. For details see the
+    /streams/`start_recording` method and in knowledge base Values:
+
+    - true – auto recording is enabled
+    - false – auto recording is disabled
+    """
+
+    backup_live: Optional[bool] = None
+    """
+    State of receiving and transcoding master stream from source by backup server if
+    you pushing stream to "`backup_push_url`" or "`backup_push_url_srt`". Displays
+    the backup server status of PUSH method only. For PULL a "live" field is always
+    used, even when origin servers are switched using round robin scheduling (look
+    "uri" field for details).
+    """
+
+    backup_push_url: Optional[str] = None
+    """URL to PUSH master stream to our backup server using RTMP/S protocols.
+
+    Servers for the main and backup streams are distributed geographically. Mainly
+    sending one stream to main server is enough. But if you need a backup stream,
+    then this is the field to PUSH it. To use RTMPS just manually change the
+    protocol name from "rtmp://" to "rtmps://". The backup logs are as follows: In
+    PUSH mode, you initiate sending a stream from your machine. If your stream stops
+    or breaks for some reason and it stops coming to the main server, then after
+    3-10 seconds of waiting the stream will turn off or the backup one will be
+    automatically turned on, if you are pushing it too.
+    """
+
+    backup_push_url_srt: Optional[str] = None
+    """
+    URL to PUSH master stream to our backup server using SRT protocol with the same
+    logic of backup-streams
+    """
+
+    broadcast_ids: Optional[List[int]] = None
+    """IDs of broadcasts which will include this stream"""
+
+    cdn_id: Optional[int] = None
+    """
+    ID of custom CDN resource from which the content will be delivered (only if you
+    know what you do)
+    """
+
+    client_entity_data: Optional[str] = None
+    """
+    Custom meta field designed to store your own extra information about a video
+    entity: video source, video id, parameters, etc. We do not use this field in any
+    way when processing the stream. You can store any data in any format (string,
+    json, etc), saved as a text string. Example:
+    `` client_entity_data = '{ "`seq_id`": "1234567890", "name": "John Doe", "iat": 1516239022 }' ``
+    """
+
+    client_user_id: Optional[int] = None
+    """Custom meta field for storing the Identifier in your system.
+
+    We do not use this field in any way when processing the stream. Example:
+    `client_user_id = 1001`
+    """
+
+    created_at: Optional[str] = None
+    """Datetime of creation in ISO 8601"""
+
+    dash_url: Optional[str] = None
+    """MPEG-DASH output.
+
+    URL for transcoded result stream in MPEG-DASH format, with .mpd link. Low
+    Latency support: YES. This is CMAF-based MPEG-DASH stream. Encoder and packager
+    dynamically assemble the video stream with fMP4 fragments. Chunks have ±2-4
+    seconds duration depending on the settings. All chunks for DASH are transferred
+    through CDN using chunk transfer technology, which allows to use all the
+    advantages of low latency delivery of DASH.
+
+    - by default low latency is ±4 sec, because it's stable for almost all last-mile
+      use cases.
+    - and its possible to enable ±2 sec for DASH, just ask our Support Team.
+
+    Read more information in the article "How Low Latency streaming works" in the
+    Knowledge Base.
+    """
+
+    dvr_duration: Optional[int] = None
+    """DVR duration in seconds if DVR feature is enabled for the stream.
+
+    So this is duration of how far the user can rewind the live stream.
+    `dvr_duration` range is [30...14400]. Maximum value is 4 hours = 14400 seconds.
+    If you need more, ask the Support Team please.
+    """
+
+    dvr_enabled: Optional[bool] = None
+    """Enables DVR for the stream:
+
+    - true – DVR is enabled
+    - false – DVR is disabled
+    """
+
+    finished_at_primary: Optional[str] = None
+    """Time when the stream ended for the last time.
+
+    Datetime in ISO 8601. After restarting the stream, this value is not reset to
+    "null", and the time of the last/previous end is always displayed here. That is,
+    when the start time is greater than the end time, it means the current session
+    is still ongoing and the stream has not ended yet. If you want to see all
+    information about acitivity of the stream, you can get it from another method
+    /streaming/statistics/ffprobe. This method shows aggregated activity parameters
+    during a time, when stream was alive and transcoded. Also you can create graphs
+    to see the activity. For example
+    /streaming/statistics/ffprobe?interval=6000&`date_from`=2023-10-01&`date_to`=2023-10-11&`stream_id`=12345
+    """
+
+    frame_rate: Optional[float] = None
+    """Current FPS of the original stream, if stream is transcoding"""
+
+    hls_cmaf_url: Optional[str] = None
+    """HLS output.
+
+    URL for transcoded result of stream in HLS CMAF format, with .m3u8 link.
+    Recommended for use for all HLS streams. Low Latency support: YES. This is
+    CMAF-based HLS stream. Encoder and packager dynamically assemble the video
+    stream with fMP4 fragments. Chunks have ±2-4 seconds duration depending on the
+    settings. All chunks for LL-HLS are transferred through CDN via dividing into
+    parts (small segments `#EXT-X-PART` of 0.5-1.0 sec duration), which allows to
+    use all the advantages of low latency delivery of LL-HLS.
+
+    - by default low latency is ±5 sec, because it's stable for almost all last-mile
+      use cases.
+    - and its possible to enable ±3 sec for LL-HLS, just ask our Support Team.
+
+    It is also possible to use modifier-attributes, which are described in the
+    "`hls_mpegts_url`" field above. If you need to get MPEGTS (.ts) chunks, look at
+    the attribute "`hls_mpegts_url`".
+
+    Read more information in the article "How Low Latency streaming works" in the
+    Knowledge Base.
+    """
+
+    hls_mpegts_endlist_tag: Optional[bool] = None
+    """
+    Add `#EXT-X-ENDLIST` tag within .m3u8 playlist after the last segment of a live
+    stream when broadcast is ended.
+    """
+
+    hls_mpegts_url: Optional[str] = None
+    """HLS output for legacy devices.
+
+    URL for transcoded result of stream in HLS MPEGTS (.ts) format, with .m3u8 link.
+    Low Latency support: NO. Some legacy devices or software may require MPEGTS
+    (.ts) segments as a format for streaming, so we provide this options keeping
+    backward compatibility with any of your existing workflows. For other cases it's
+    better to use "`hls_cmaf_url`" instead. You can use this legacy HLSv6 format
+    based on MPEGTS segmenter in parallel with main HLS CMAF. Both formats are
+    sharing same segments size, manifest length (DVR), etc.
+
+    It is also possible to use additional modifier-attributes:
+
+    - ?`get_duration_sec`=true – Adds the real segment duration in seconds to chunk
+      requests. A chunk duration will be automatically added to a chunk request
+      string with the "`duration_sec`" attribute. The value is an integer for a
+      length multiple of whole seconds, or a fractional number separated by a dot
+      for chunks that are not multiples of seconds. This attribute allows you to
+      determine duration in seconds at the level of analyzing the logs of CDN
+      requests and compare it with file size (so to use it in your analytics). Such
+      modifier attributes are applied manually and added to the link obtained from
+      this field. I.e. `` ?`get_duration_sec`=true `` Example:
+      `https://demo.gvideo.io/mpegts/`2675_19146`/`master_mpegts`.m3u8?`get_duration_sec`=true`
+
+    ```
+    #EXTM3U
+    #EXT-X-VERSION:6
+    #EXT-X-TARGETDURATION:2
+    ...
+    #EXTINF:2.000000,
+    #EXT-X-PROGRAM-DATE-TIME:2025-08-14T08:15:00
+    seg1.ts?`duration_sec`=2
+    ...
+    ```
+    """
+
+    html_overlay: Optional[bool] = None
+    """
+    Switch on mode to insert and display real-time HTML overlay widgets on top of
+    live streams
+    """
+
+    html_overlays: Optional[List[Overlay]] = None
+    """Array of HTML overlay widgets"""
+
+    iframe_url: Optional[str] = None
+    """A URL to a built-in HTML web player with the stream inside.
+
+    It can be inserted into an iframe on your website and the video will
+    automatically play in all browsers. Please, remember that transcoded streams
+    from "`hls_cmaf_url`" with .m3u8 at the end, and from "`dash_url`" with .mpd at
+    the end are to be played inside video players only. For example: AVplayer on
+    iOS, Exoplayer on Android, HTML web player in browser, etc. General bowsers like
+    Chrome, Firefox, etc cannot play transcoded streams with .m3u8 and .mpd at the
+    end. The only exception is Safari, which can only play Apple's HLS .m3u8 format
+    with limits. That's why you may need to use this HTML web player. Please, look
+    Knowledge Base for details. Example of usage on a web page:
+
+    <iframe width="560" height="315" src="https://player.gvideo.co/streams/`2675_201693`" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
+    """
+
+    live: Optional[bool] = None
+    """State of receiving and transcoding master stream from source by main server"""
+
+    low_latency_enabled: Optional[bool] = None
+    """
+    Deprecated, always returns "true". The only exception is that the attribute can
+    only be used by clients that have previously used the old stream format. This
+    method is outdated since we've made it easier to manage streams. For your
+    convenience, you no longer need to set this parameter at the stage of creating a
+    stream. Now all streams are prepared in 2 formats simultaniously: Low Latency
+    and Legacy. You can get the desired output format in the attributes
+    "`dash_url`", "`hls_cmaf_url`", "`hls_mpegts_url`". Or use them all at once.
+
+    ---
+
+    Note: Links /streams/{id}/playlist.m3u8 are depricated too. Use value of the
+    "`hls_mpegts_url`" attribute instead.
+    """
+
+    projection: Optional[Literal["regular", "vr360", "vr180", "vr360tb"]] = None
+    """
+    Visualization mode for 360° streams, how the stream is rendered in our web
+    player ONLY. If you would like to show video 360° in an external video player,
+    then use parameters of that video player. Modes:
+
+    - regular – regular “flat” stream
+    - vr360 – display stream in 360° mode
+    - vr180 – display stream in 180° mode
+    - vr360tb – display stream in 3D 360° mode Top-Bottom
+    """
+
+    pull: Optional[bool] = None
+    """Indicates if stream is pulled from external server or not.
+
+    Has two possible values:
+
+    - true – stream is received by PULL method. Use this when need to get stream
+      from external server by srt, rtmp\\ss, hls, dash, etc protocols.
+    - false – stream is received by PUSH method. Use this when need to send stream
+      from end-device to our Streaming Platform, i.e. from mobile app or OBS Studio.
+    """
+
+    push_url: Optional[str] = None
+    """
+    URL to PUSH master stream to our main server using RTMP and RTMPS protocols. To
+    use RTMPS just manually change the protocol name from "rtmp://" to "rtmps://".
+    If you see an error like "invalid SSL certificate" try the following:
+
+    - Make sure the push URL is correct, and it contains "rtmps://".
+    - If the URL looks correct but you still get an SSL error, try specifying the
+      port 443 in the URL. Here’s an example:
+      rtmps://vp-push.domain.com:443/in/stream?key.
+    - If you're still having trouble, then your encoder may not support RTMPS.
+      Double-check the documentation for your encoder. For advanced customers only:
+      For your complexly distributed broadcast systems, it is also possible to
+      additionally output an array of multi-regional ingestion points for manual
+      selection from them. To activate this mode, contact your manager or the
+      Support Team to activate the "`multi_region_push_urls`" attibute. But if you
+      clearly don’t understand why you need this, then it’s best to use the default
+      single URL in the "`push_url`" attribute.
+    """
+
+    push_url_srt: Optional[str] = None
+    """
+    URL to PUSH master stream to our main server using SRT protocol. Use only 1
+    protocol of sending a master stream: either only SRT (`push_url_srt`), or only
+    RTMP (`push_url`).
+    """
+
+    push_url_whip: Optional[str] = None
+    """URL to PUSH WebRTC stream to our server using WHIP protocol.
+
+    **WebRTC WHIP to LL-HLS and DASH** Video Streaming supports WebRTC HTTP Ingest
+    Protocol (WHIP), and WebRTC to HLS/DASH converter. As a result you can stream
+    from web broswers natively. **WebRTC WHIP server** We have dedicated WebRTC WHIP
+    servers in our infrastructure. WebRTC WHIP server organizes both signaling and
+    receives video data. Signaling is a term to describe communication between
+    WebRTC endpoints, needed to initiate and maintain a session. WHIP is an open
+    specification for a simple signaling protocol for starting WebRTC sessions in an
+    outgoing direction, (i.e., streaming from your device). **WebRTC stream encoding
+    parameters** At least one video and audio track both must be present in the
+    stream:
+
+    - Video must be encoded with H.264.
+    - Audio must be encoded with OPUS. Note. Specifically for WebRTC mode a method
+      of constant transcoding with an initial given resolution is used. This means
+      that if WebRTC in the end-user's browser decides to reduce the quality or
+      resolution of the master stream (to let say 360p) due to restrictions on the
+      end-user's device (network conditions, CPU consumption, etc.), the transcoder
+      will still continue to transcode the reduced stream to the initial resolution
+      (let say 1080p ABR). When the restrictions on the end-user's device are
+      removed, quiality will improve again. **WebRTC WHIP Client** We provide a
+      convenient WebRTC WHIP library for working in browsers. You can use our
+      library, or any other you prefer. Simple example of usage is here:
+      https://stackblitz.com/edit/stackblitz-starters-j2r9ar?file=index.html Also
+      try to use the feature in UI of the Customer Portal. In the Streaming section
+      inside the settings of a specific live stream, a new section "Quick start in
+      browser" has been added. More information in the Product Documentation on the
+      website.
+    """
+
+    quality_set_id: Optional[int] = None
+    """
+    Custom quality set ID for transcoding, if transcoding is required according to
+    your conditions. Look at GET /`quality_sets` method
+    """
+
+    record_type: Optional[Literal["origin", "transcoded"]] = None
+    """Method of recording a stream.
+
+    Specifies the source from which the stream will be recorded: original or
+    transcoded. Types:
+
+    - "origin" – To record RMTP/SRT/etc original clean media source.
+    - "transcoded" – To record the output transcoded version of the stream,
+      including overlays, texts, logos, etc. additional media layers.
+    """
+
+    recording_duration: Optional[float] = None
+    """Duration of current recording in seconds if recording is enabled for the stream"""
+
+    screenshot: Optional[str] = None
+    """
+    An instant screenshot taken from a live stream, and available as a static JPEG
+    image. Resolution 1080 pixels wide, or less if the original stream has a lower
+    resolution. Screenshot is taken every 10 seconds while the stream is live. This
+    field contains a link to the last screenshot created by the system. Screenshot
+    history is not stored, so if you need a series of screenshots over time, then
+    download them.
+    """
+
+    started_at_backup: Optional[str] = None
+    """Time of the last session when backup server started receiving the stream.
+
+    Datetime in ISO 8601
+    """
+
+    started_at_primary: Optional[str] = None
+    """Time of the last session when main server started receiving the stream.
+
+    Datetime in ISO 8601. This means that if the stream was started 1 time, then
+    here will be the time it was started. If the stream was started several times,
+    or restarted on your side, then only the time of the last session is displayed
+    here.
+    """
+
+    transcoded_qualities: Optional[List[str]] = None
+    """Array of qualities to which live stream is transcoded"""
+
+    transcoding_speed: Optional[float] = None
+    """Speed of transcoding the stream. Mainly it must be 1.0 for real-time processing.
+
+    May be less than 1.0 if your stream has problems in delivery due to your local
+    internet provider's conditions, or the stream does not meet stream inbound
+    requirements. See Knowledge Base for details.
+    """
+
+    uri: Optional[str] = None
+    """
+    When using PULL method, this is the URL to pull a stream from. You can specify
+    multiple addresses separated by a space (" "), so you can organize a backup
+    plan. In this case, the specified addresses will be selected one by one using
+    round robin scheduling. If the first address does not respond, then the next one
+    in the list will be automatically requested, returning to the first and so on in
+    a circle. Also, if the sucessfully working stream stops sending data, then the
+    next one will be selected according to the same scheme. After 24 hours of
+    inactivity of your streams we will stop PULL-ing, and will switch "active" field
+    to "false". Please, note that this field is for PULL only, so is not suitable
+    for PUSH. Look at fields "`push_url`" and "`push_url_srt`" from GET method.
+    """
+
+    video_height: Optional[float] = None
+    """Current height of frame of the original stream, if stream is transcoding"""
+
+    video_width: Optional[float] = None
+    """Current width of frame of the original stream, if stream is transcoding"""

gcore/types/streaming/stream_create_clip_params.py

@@ -0,0 +1,48 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["StreamCreateClipParams"]
+
+
+class StreamCreateClipParams(TypedDict, total=False):
+    duration: Required[int]
+    """
+    Requested segment duration in seconds to be cut. Please, note that cutting is
+    based on the idea of instantly creating a clip, instead of precise timing. So
+    final segment may be:
+
+    - Less than the specified value if there is less data in the DVR than the
+      requested segment.
+    - Greater than the specified value, because segment is aligned to the first and
+      last key frames of already stored fragment in DVR, this way -1 and +1 chunks
+      can be added to left and right. Duration of cutted segment cannot be greater
+      than DVR duration for this stream. Therefore, to change the maximum, use
+      "`dvr_duration`" parameter of this stream.
+    """
+
+    expiration: int
+    """
+    Expire time of the clip via a public link. Unix timestamp in seconds, absolute
+    value. This is the time how long the instant clip will be stored in the server
+    memory and can be accessed via public HLS/MP4 links. Download and/or use the
+    instant clip before this time expires. After the time has expired, the clip is
+    deleted from memory and is no longer available via the link. You need to create
+    a new segment, or use `vod_required: true` attribute. If value is omitted, then
+    expiration is counted as +3600 seconds (1 hour) to the end of the clip (i.e.
+    `unix timestamp = + + 3600`). Allowed range: 1m <= expiration <= 4h. Example:
+    `24.05.2024 14:00:00 (GMT) + 60 seconds of duration + 3600 seconds of expiration = 24.05.2024 15:01:00 (GMT) is Unix timestamp = 1716562860`
+    """
+
+    start: int
+    """
+    Starting point of the segment to cut. Unix timestamp in seconds, absolute value.
+    Example: `24.05.2024 14:00:00 (GMT) is Unix timestamp = 1716559200` If a value
+    from the past is specified, it is used as the starting point for the segment to
+    cut. If the value is omitted, then clip will start from now.
+    """
+
+    vod_required: bool
+    """Indicates if video needs to be stored also as permanent VOD"""

gcore/types/streaming/stream_create_params.py

@@ -0,0 +1,165 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["StreamCreateParams"]
+
+
+class StreamCreateParams(TypedDict, total=False):
+    name: Required[str]
+    """
+    Stream name. Often used as a human-readable name for the stream, but can contain
+    any text you wish. The values are not unique and may be repeated. Examples:
+
+    - Conference in July
+    - Stream #10003
+    - Open-Air Camera #31 Backstage
+    - 480fd499-2de2-4988-bc1a-a4eebe9818ee
+    """
+
+    active: bool
+    """Stream switch between on and off.
+
+    This is not an indicator of the status "stream is receiving and it is LIVE", but
+    rather an on/off switch. When stream is switched off, there is no way to process
+    it: PULL is deactivated and PUSH will return an error.
+
+    - true – stream can be processed
+    - false – stream is off, and cannot be processed
+    """
+
+    auto_record: bool
+    """Enables autotomatic recording of the stream when it started.
+
+    So you don't need to call recording manually. Result of recording is
+    automatically added to video hosting. For details see the
+    /streams/`start_recording` method and in knowledge base Values:
+
+    - true – auto recording is enabled
+    - false – auto recording is disabled
+    """
+
+    broadcast_ids: Iterable[int]
+    """IDs of broadcasts which will include this stream"""
+
+    cdn_id: int
+    """
+    ID of custom CDN resource from which the content will be delivered (only if you
+    know what you do)
+    """
+
+    client_entity_data: str
+    """
+    Custom meta field designed to store your own extra information about a video
+    entity: video source, video id, parameters, etc. We do not use this field in any
+    way when processing the stream. You can store any data in any format (string,
+    json, etc), saved as a text string. Example:
+    `` client_entity_data = '{ "`seq_id`": "1234567890", "name": "John Doe", "iat": 1516239022 }' ``
+    """
+
+    client_user_id: int
+    """Custom meta field for storing the Identifier in your system.
+
+    We do not use this field in any way when processing the stream. Example:
+    `client_user_id = 1001`
+    """
+
+    dvr_duration: int
+    """DVR duration in seconds if DVR feature is enabled for the stream.
+
+    So this is duration of how far the user can rewind the live stream.
+    `dvr_duration` range is [30...14400]. Maximum value is 4 hours = 14400 seconds.
+    If you need more, ask the Support Team please.
+    """
+
+    dvr_enabled: bool
+    """Enables DVR for the stream:
+
+    - true – DVR is enabled
+    - false – DVR is disabled
+    """
+
+    hls_mpegts_endlist_tag: bool
+    """
+    Add `#EXT-X-ENDLIST` tag within .m3u8 playlist after the last segment of a live
+    stream when broadcast is ended.
+    """
+
+    html_overlay: bool
+    """
+    Switch on mode to insert and display real-time HTML overlay widgets on top of
+    live streams
+    """
+
+    low_latency_enabled: bool
+    """
+    Deprecated, always returns "true". The only exception is that the attribute can
+    only be used by clients that have previously used the old stream format. This
+    method is outdated since we've made it easier to manage streams. For your
+    convenience, you no longer need to set this parameter at the stage of creating a
+    stream. Now all streams are prepared in 2 formats simultaniously: Low Latency
+    and Legacy. You can get the desired output format in the attributes
+    "`dash_url`", "`hls_cmaf_url`", "`hls_mpegts_url`". Or use them all at once.
+
+    ---
+
+    Note: Links /streams/{id}/playlist.m3u8 are depricated too. Use value of the
+    "`hls_mpegts_url`" attribute instead.
+    """
+
+    projection: Literal["regular", "vr360", "vr180", "vr360tb"]
+    """
+    Visualization mode for 360° streams, how the stream is rendered in our web
+    player ONLY. If you would like to show video 360° in an external video player,
+    then use parameters of that video player. Modes:
+
+    - regular – regular “flat” stream
+    - vr360 – display stream in 360° mode
+    - vr180 – display stream in 180° mode
+    - vr360tb – display stream in 3D 360° mode Top-Bottom
+    """
+
+    pull: bool
+    """Indicates if stream is pulled from external server or not.
+
+    Has two possible values:
+
+    - true – stream is received by PULL method. Use this when need to get stream
+      from external server by srt, rtmp\\ss, hls, dash, etc protocols.
+    - false – stream is received by PUSH method. Use this when need to send stream
+      from end-device to our Streaming Platform, i.e. from mobile app or OBS Studio.
+    """
+
+    quality_set_id: int
+    """
+    Custom quality set ID for transcoding, if transcoding is required according to
+    your conditions. Look at GET /`quality_sets` method
+    """
+
+    record_type: Literal["origin", "transcoded"]
+    """Method of recording a stream.
+
+    Specifies the source from which the stream will be recorded: original or
+    transcoded. Types:
+
+    - "origin" – To record RMTP/SRT/etc original clean media source.
+    - "transcoded" – To record the output transcoded version of the stream,
+      including overlays, texts, logos, etc. additional media layers.
+    """
+
+    uri: str
+    """
+    When using PULL method, this is the URL to pull a stream from. You can specify
+    multiple addresses separated by a space (" "), so you can organize a backup
+    plan. In this case, the specified addresses will be selected one by one using
+    round robin scheduling. If the first address does not respond, then the next one
+    in the list will be automatically requested, returning to the first and so on in
+    a circle. Also, if the sucessfully working stream stops sending data, then the
+    next one will be selected according to the same scheme. After 24 hours of
+    inactivity of your streams we will stop PULL-ing, and will switch "active" field
+    to "false". Please, note that this field is for PULL only, so is not suitable
+    for PUSH. Look at fields "`push_url`" and "`push_url_srt`" from GET method.
+    """

gcore/types/streaming/stream_list_clips_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .clip import Clip
+
+__all__ = ["StreamListClipsResponse"]
+
+StreamListClipsResponse: TypeAlias = List[Clip]

gcore/types/streaming/stream_list_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["StreamListParams"]
+
+
+class StreamListParams(TypedDict, total=False):
+    page: int
+    """Query parameter. Use it to list the paginated content"""
+
+    with_broadcasts: int
+    """Query parameter.
+
+    Set to 1 to get details of the broadcasts associated with the stream
+    """

gcore/types/streaming/stream_series.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = ["StreamSeries", "StreamSeryItem", "StreamSeryItemMetrics"]
+
+
+class StreamSeryItemMetrics(BaseModel):
+    streams: List[int]
+
+
+class StreamSeryItem(BaseModel):
+    client: int
+
+    metrics: StreamSeryItemMetrics
+
+
+StreamSeries: TypeAlias = List[StreamSeryItem]