Reencode Video

Reencode Video

curl --request POST \
  --url https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode \
  --header 'AccessKey: <api-key>'

import requests

url = "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode"

headers = {"AccessKey": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {AccessKey: '<api-key>'}};

fetch('https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "AccessKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("AccessKey", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["AccessKey"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "videoLibraryId": 123,
  "guid": "<string>",
  "title": "<string>",
  "dateUploaded": "2023-11-07T05:31:56Z",
  "views": 123,
  "isPublic": true,
  "length": 123,
  "status": 0,
  "framerate": 123,
  "width": 123,
  "height": 123,
  "outputCodecs": "<string>",
  "thumbnailCount": 123,
  "encodeProgress": 123,
  "storageSize": 123,
  "hasMP4Fallback": true,
  "averageWatchTime": 123,
  "totalWatchTime": 123,
  "description": "<string>",
  "rotation": 123,
  "availableResolutions": "<string>",
  "captions": [
    {
      "srclang": "<string>",
      "label": "<string>",
      "version": 123
    }
  ],
  "collectionId": "<string>",
  "thumbnailFileName": "<string>",
  "thumbnailUrl": "<string>",
  "thumbnailBlurhash": "<string>",
  "category": "<string>",
  "chapters": [
    {
      "title": "<string>",
      "start": 123,
      "end": 123
    }
  ],
  "moments": [
    {
      "label": "<string>",
      "timestamp": 123
    }
  ],
  "metaTags": [
    {
      "property": "<string>",
      "value": "<string>"
    }
  ],
  "transcodingMessages": [
    {
      "timeStamp": "2023-11-07T05:31:56Z",
      "level": 0,
      "issueCode": 0,
      "message": "<string>",
      "value": "<string>"
    }
  ],
  "jitEncodingEnabled": true,
  "smartGenerateStatus": 0,
  "smartGenerateFeaturesStatus": {
    "title": 0,
    "description": 0,
    "chapters": 0,
    "moments": 0
  },
  "hasOriginal": true,
  "originalHash": "<string>",
  "hasHighQualityPreview": true
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

POST

library

{libraryId}

videos

{videoId}

reencode

Reencode Video

curl --request POST \
  --url https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode \
  --header 'AccessKey: <api-key>'

import requests

url = "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode"

headers = {"AccessKey": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {AccessKey: '<api-key>'}};

fetch('https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "AccessKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("AccessKey", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://video.bunnycdn.com/library/{libraryId}/videos/{videoId}/reencode")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["AccessKey"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "videoLibraryId": 123,
  "guid": "<string>",
  "title": "<string>",
  "dateUploaded": "2023-11-07T05:31:56Z",
  "views": 123,
  "isPublic": true,
  "length": 123,
  "status": 0,
  "framerate": 123,
  "width": 123,
  "height": 123,
  "outputCodecs": "<string>",
  "thumbnailCount": 123,
  "encodeProgress": 123,
  "storageSize": 123,
  "hasMP4Fallback": true,
  "averageWatchTime": 123,
  "totalWatchTime": 123,
  "description": "<string>",
  "rotation": 123,
  "availableResolutions": "<string>",
  "captions": [
    {
      "srclang": "<string>",
      "label": "<string>",
      "version": 123
    }
  ],
  "collectionId": "<string>",
  "thumbnailFileName": "<string>",
  "thumbnailUrl": "<string>",
  "thumbnailBlurhash": "<string>",
  "category": "<string>",
  "chapters": [
    {
      "title": "<string>",
      "start": 123,
      "end": 123
    }
  ],
  "moments": [
    {
      "label": "<string>",
      "timestamp": 123
    }
  ],
  "metaTags": [
    {
      "property": "<string>",
      "value": "<string>"
    }
  ],
  "transcodingMessages": [
    {
      "timeStamp": "2023-11-07T05:31:56Z",
      "level": 0,
      "issueCode": 0,
      "message": "<string>",
      "value": "<string>"
    }
  ],
  "jitEncodingEnabled": true,
  "smartGenerateStatus": 0,
  "smartGenerateFeaturesStatus": {
    "title": 0,
    "description": 0,
    "chapters": 0,
    "moments": 0
  },
  "hasOriginal": true,
  "originalHash": "<string>",
  "hasHighQualityPreview": true
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

{
  "success": true,
  "message": "<string>",
  "statusCode": 123
}

Authorizations

AccessKey

string

header

required

AccessKey based authentication

Path Parameters

libraryId

integer<int64>

required

The ID of the video library.

videoId

string

required

The GUID of the video.

Response

The details of the requested video

videoLibraryId

integer<int64>

required

The ID of the video library that the video belongs to

guid

string

required

The unique ID of the video

Minimum string length: 1

title

string

required

The title of the video

Minimum string length: 1

dateUploaded

string<date-time>

required

The date when the video was uploaded

Minimum string length: 1

views

integer<int64>

required

The number of views the video received

isPublic

boolean

required

Determines if the video is publically accessible

length

integer<int32>

required

The duration of the video in seconds

status

required

The status of the video. See VideoModelStatus.

Available options:

0

framerate

number<double>

required

The framerate of the video

width

integer<int32>

required

The width of the original video file

height

integer<int32>

required

The height of the original video file

outputCodecs

string

required

Comma-separated list of output codecs generated for this video (e.g. "x264,vp9"). See EncoderOutputCodec for possible values.

Minimum string length: 1

thumbnailCount

integer<int32>

required

The number of thumbnails generated for this video

encodeProgress

integer<int32>

required

Encoding progress as a percentage from 0 to 100; reaches 100 when transcoding finishes.

storageSize

integer<int64>

required

Total storage used by this video, in bytes.

hasMP4Fallback

boolean

required

Determines if the video has MP4 fallback files generated

averageWatchTime

integer<int64>

required

The average watch time of the video in seconds

totalWatchTime

integer<int64>

required

The total video watch time in seconds

description

string | null

The description of the video

rotation

integer | null

Rotation of the source file in degrees as read from container metadata (e.g. 90, -90, 180, 270); null when no rotation metadata is present.

availableResolutions

string | null

Comma-separated list of resolution labels (e.g. "360p,720p,1080p") that have finished encoding and are available for playback.

captions

object[] | null

The list of captions available for the video

Show child attributes

collectionId

string | null

The ID of the collection where the video belongs

thumbnailFileName

string | null

The file name of the thumbnail inside of the storage

thumbnailUrl

string | null

The CDN URL of the thumbnail

thumbnailBlurhash

string | null

Thumbnail blurhash to show while the actual thumbnail is being loaded

API Reference

Core Platform API

Origin Errors API

CDN Logging API

Storage API

Stream API

Shield API

Edge Scripting API

Magic Containers API

Authorizations

Path Parameters

Response