v1

latestOpenAPI 3.0.02026-07-175989869.3 KB

Videos

Create a video object

Creates a video object. More information on video objects can be found here.

post/videos

Request body

titlestring required

The title of your new video.

descriptionstring

A brief description of your video.

sourcestring

You can either add a video already on the web, by entering the URL of the video, or you can also enter the videoId of one of the videos you already have on your api.video acccount, and this will generate a copy of your video. Creating a copy of a video can be especially useful if you want to keep your original video and trim or apply a watermark onto the copy you would create.

publicboolean

Default: True. If set to false the video will become private. More information on private videos can be found here

panoramicboolean

Indicates if your video is a 360/immersive video.

mp4Supportboolean

Enables mp4 version in addition to streamed version.

playerIdstring

The unique identification number for your video player.

tagsstring[]

A list of tags you want to use to describe your video.

language'ar' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fa' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'it' | 'ja' | 'ko' | 'ml' | 'nl' | 'nn' | 'false' | 'pl' | 'pt' | 'ru' | 'sk' | 'sl' | 'te' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' nullable

Use this parameter to set the language of the video. When this parameter is set, the API creates a transcript of the video using the language you specify. You must use the IETF language tag format.

language is a permanent attribute of the video. You can update it to another language using the PATCH /videos/{videoId} operation. This triggers the API to generate a new transcript using a different language.

transcriptboolean

Use this parameter to enable transcription.

When true, the API generates a transcript for the video.
The default value is false.
If you define a video language using the language parameter, the API uses that language to transcribe the video. If you do not define a language, the API detects it based on the video.
When the API generates a transcript, it will be available as a caption for the video.

transcriptSummaryboolean

Use this parameter to enable summarization. We recommend using this parameter together with transcript: true.

When true, the API generates a summary for the video, based on the transcription.
The default value is false.
If you define a video language using the language parameter, the API uses that language to summarize the video. If you do not define a language, the API detects it based on the video.

transcriptSummaryAttributesstring[]

Use this parameter to define the elements of a summary that you want to generate. If you do not define this parameter, the API generates a full summary with all attributes. The possible values are abstract and takeaways.

Example request

{
  "title": "Maths video",
  "description": "An amazing video explaining string theory.",
  "public": false,
  "panoramic": false,
  "mp4Support": true,
  "playerId": "pl45KFKdlddgk654dspkze",
  "language": "en",
  "transcript": true,
  "transcriptSummary": true,
  "transcriptSummaryAttributes": [
    "abstract",
    "takeaways"
  ],
  "tags": [
    "maths",
    "string theory",
    "video"
  ],
  "metadata": [
    {
      "key": "Author",
      "value": "John Doe"
    },
    {
      "key": "Format",
      "value": "Tutorial"
    }
  ],
  "watermark": {
    "id": "watermark_1BWr2L5MTQwxGkuxKjzh6i",
    "bottom": "10px",
    "right": "10px",
    "width": "50%",
    "opacity": "70%"
  }
}

Response

Created

videoIdstring required

The unique identifier of the video object.

createdAtstring date-time

When a video was created, presented in ATOM UTC format.

titlestring

The title of the video content.

descriptionstring

A description for the video content.

publishedAtstring date-time

The date and time the API created the video. Date and time are provided using ATOM UTC format.

updatedAtstring date-time

The date and time the video was updated. Date and time are provided using ATOM UTC format.

discardedAtstring date-time nullable

The date and time the video was discarded. The API populates this field only if you have the Video Restore feature enabled and discard a video. Date and time are provided using ATOM UTC format.

deletesAtstring date-time nullable

The date and time the video will be permanently deleted. The API populates this field only if you have the Video Restore feature enabled and discard a video. Discarded videos are pemanently deleted after 90 days. Date and time are provided using ATOM UTC format.

discardedboolean

Returns true for videos you discarded when you have the Video Restore feature enabled. Returns false for every other video.

languagestring

Returns the language of a video in IETF language tag format. You can set the language during video creation via the API, otherwise it is detected automatically.

languageOrigin'api' | 'auto' nullable

Returns the origin of the last update on the video's language attribute.

api means that the last update was requested from the API.
auto means that the last update was done automatically by the API.

tagsstring[]

One array of tags (each tag is a string) in order to categorize a video. Tags may include spaces.

playerIdstring

The id of the player that will be applied on the video.

publicboolean

Defines if the content is publicly reachable or if a unique token is needed for each play session. Default is true. Tutorials on private videos.

panoramicboolean

Defines if video is panoramic.

mp4Supportboolean

This lets you know whether mp4 is supported. If enabled, an mp4 URL will be provided in the response for the video.

Example response

{
  "videoId": "vi4k0jvEUuaTdRAEjQ4Jfrgz",
  "title": "Maths video",
  "description": "An amazing video explaining the string theory",
  "language": "en",
  "languageOrigin": "api",
  "tags": [
    "maths",
    "string theory",
    "video"
  ],
  "metadata": [
    {
      "key": "Author",
      "value": "John Doe"
    },
    {
      "key": "Format",
      "value": "Tutorial"
    }
  ],
  "createdAt": "2024-03-03T12:52:03+00:00",
  "publishedAt": "2024-07-14T23:36:07+00:00",
  "discarded": false,
  "discardedAt": null,
  "deletesAt": null,
  "actions": [
    "video_delete",
    "video_download",
    "video_update"
  ]
}