Skip to main content

Create video

POST 
/videos/vod

Create video container with all informations and configurations. Upload a video To make the video upload, you must first create the video, and then make the upload to a signed url. Learn more

Request​

Header Parameters

    Content-Type stringrequired
    Example: application/x-www-form-urlencoded
    Accept stringrequired
    Example: application/json

Body

    title stringrequired

    Title of video

    Example: New video
    description string

    Description of video

    Example: This is a description
    tag_ids[] string

    Tags of video

    Example: 4236
    privacy string

    Privacy of content (hidden, public, registered)

    Example: public
    collection_id string

    Id collection to attach video

    Example: 88567
    audio_language string

    Define original audio language (useful to transcript captions)

    Example: IT
    origin_url string

    URL of the original file to be copied from external storage. If specified, the system will download the file and use it as the video source for transcoding.

    Example: https://example.com/video-file.mp4
    clip_start_seconds integer

    To transcode only a specific segment of a video rather than its entire length, you can provide timecodes for the starting point and duration of the segment to process. The starting point is specified in seconds.

    Example: 0
    clip_duration_seconds integer

    Specifies the length of the segment to transcode, rather than processing the entire video. This parameter is only used in conjunction with the starting point of a segment. The duration is expressed in seconds.

    Example: 15
    projection string

    Specifies the visualization mode for 360° streams, determining how the stream is rendered in our web player. Note: For displaying 360° video in external players, use the parameters specific to that player. Available modes:

    • regular: Standard "flat" stream display
    • vr360: Full 360° viewing mode
    • vr180: 180° viewing mode
    • vr360tb: 3D 360° Top-Bottom viewing mode"

    Possible values: [regular, vr180, vr360, vr360tb]

    Default value: regular
    Example: regular

Responses​

Response Headers

    Schema

      id stringrequired
      status stringrequired
    Loading...