Create profile

Developing

POST

/libraries/{libraryID}/encoding-profiles/{encodingType}

Create Encoding profile of a library

📣 this endpoint creates a new video encoding profile for a library . In this POST
request the library_id and transcoding type vod | live has to be provided . All the necessary data has to be provided in the request payload

✳ list of URL parameters

library_id = 36 character in length

encodingType = vod | live

📢 Info message : Here URL is contructed like
POST /libraries/<library_id>/encoding-profiles/<encodingType>

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.vidinfra.com/libraries//encoding-profiles/vod' \
--header 'Content-Type: application/json' \
--data-raw '// {
//     "project_id": "f32a0116-fe11-454c-8e6a-5ff4101882e5",
//     "name": "Profile3",
//     "is_default": true,
//     "enable_per_title_encoding": false,
//     "thumbnail": {
//         "time" : 0.1 ,
//         "image_format" : "jpg" ,
//         "height" :270,
//         "width" : 270,
//         "output_path" : ".jpg"
//     },
//     "generate_mp4": true,
//     "crop": {
//         "x": 10,
//         "y": 20,
//         "out_w": 100,
//         "out_h": 200
//     },
//     "image_overlay": {
//         "url": "http://example.com/overlay.jpg"
//     },
//     "text_overlay": {
//         "text": "Raka"
//     },
//     "trim": {
//         "start": 10,
//         "end": 20
//     },
//    "encoding_presets": [
//         {
//             "width": 1920,
//             "height": 1080,
//             "min_bitrate": 1000,
//             "max_bitrate": 5000,
//             "optimize_bitrate": true,
//             "bitrate": 3000,
//             "video_codec": "h264",
//             "audio_codec": "aac",
//             "audio_rate": 128
//         },
//         {
//             "width": 1080,
//             "height": 720,
//             "min_bitrate": 2000,
//             "max_bitrate": 6000,
//             "optimize_bitrate": true,
//             "bitrate": 5000,
//             "video_codec": "h265",
//             "audio_codec": "aac",
//             "audio_rate": 128
//         }
//    ]
// }


// 2nd example 

{
    "project_id": "2c699add-7989-4460-992c-51829176f9ac",
    "name": "Profile3",
    "is_default": true,
    "enable_per_title_encoding": false,
    "thumbnail": {
        "time": 0.1,
        "image_format": "jpg",
        "height": 270,
        "width": 270,
        "output_path": ".jpg"
    },
    "generate_mp4": true,
    "crop": {
        "x": 10,
        "y": 20,
        "out_w": 100,
        "out_h": 200
    },
    "image_overlay": {
        "url": "http://example.com/overlay.jpg"
    },
    "text_overlay": {
        "text": "Raka"
    },
    "trim": {
        "start": 10,
        "end": 20
    },
    "encoding_presets": [
        {
             "width": 1920,
            "height": 1080,
            "min_bitrate": 1000,
            "max_bitrate": 5000,
            "optimize_bitrate": true,
            "bitrate": 3000,
            "video_codec": "h264",
            "audio_codec": "aac",
            "audio_rate": 128
        },
        {
            "width": 1280,
            "height": 720,
            "min_bitrate": 1000,
            "max_bitrate": 5000,
            "optimize_bitrate": true,
            "bitrate": 3000,
            "video_codec": "h264",
            "audio_codec": "aac",
            "audio_rate": 128
        },
        {
            "width": 854,
            "height": 480,
            "min_bitrate": 1000,
            "max_bitrate": 1500,
            "optimize_bitrate": true,
            "bitrate": 1500,
            "video_codec": "h264",
            "audio_codec": "aac",
            "audio_rate": 128
        },
       
        {
            "width": 640,
            "height": 360,
            "min_bitrate": 1000,
            "max_bitrate": 1000,
            "optimize_bitrate": true,
            "bitrate": 1000,
            "video_codec": "h264",
            "audio_codec": "aac",
            "audio_rate": 128
        },
       
       {
            "width": 426,
            "height": 240,
            "min_bitrate": 1000,
            "max_bitrate": 1000,
            "optimize_bitrate": true,
            "bitrate": 1000,
            "video_codec": "h264",
            "audio_codec": "aac",
            "audio_rate": 128
        },
    ]
}'

Response Example

{"message":"encoding Created Successfully","result":{"id":"47f8da4f-a35b-463f-9343-10d29980d8b9","project_id":"8813d154-3e6a-457e-bcdb-283ede3fe365","name":"Profile3","is_default":true,"enable_per_title_encoding":false,"thumbnail":{"time":0.1,"image_format":"jpg","height":270,"width":270,"output_path":".jpg"},"generate_mp4":true,"crop":{"x":10,"y":20,"out_w":100,"out_h":200},"image_overlay":{"url":"http://example.com/overlay.jpg"},"text_overlay":{"text":"Raka"},"trim":{"start":10,"end":20},"created_at":"2024-04-17T10:47:33.899513007Z","created_by":"04f131d0-b8d5-42cd-8e66-9495299e75cf","encoding_presets":[{"id":"dea7ffdb-41a3-4784-b295-57faf0ab4ed8","encoding_profile_id":"47f8da4f-a35b-463f-9343-10d29980d8b9","width":1920,"height":1080,"min_bitrate":1000,"max_bitrate":5000,"optimize_bitrate":true,"bitrate":3000,"video_codec":"h264","audio_codec":"aac","audio_rate":128},{"id":"1c8ed759-5009-4d6a-9713-f230da34e49b","encoding_profile_id":"47f8da4f-a35b-463f-9343-10d29980d8b9","width":1080,"height":720,"min_bitrate":2000,"max_bitrate":6000,"optimize_bitrate":true,"bitrate":5000,"video_codec":"h265","audio_codec":"aac","audio_rate":128}]},"success":true}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

Modified at 2025-07-16 08:21:37

Get all profiles

Get A profile

Create profile

Create Encoding profile of a library#

Request

Responses

Create Encoding profile of a library