Videos

Create video

Use this method to create a new video entity.

Methods of creating To upload the original video file to the server, there are several possible scenarios:

Copy from another server – If your video is accessable via “http://”, “https://”, or “sftp://” public link, then you can use this method to copy a file from an external server. Set origin_url parameter with the link to the original video file (i.e. “https://domain.com/video.mp4”). After method execution file will be uploaded and will be sent to transcoding automatically, you don’t have to do anything else. Use extra field origin_http_headers if authorization is required on the external server.
Direct upload from a local device – If you need to upload video directly from your local device or from a mobile app, then use this method. Keep origin_url empty and use TUS protocol (tus.io) to upload file. More details are here “Get TUS’ upload” After getting the video, it is processed through the queue. There are 2 priority criteria: global and local. Global is determined automatically by the system as converters are ready to get next video, so your videos rarely queue longer than usual (when you don’t have a dedicated region). Local priority works at the level of your account and you have full control over it, look at “priority” attribute.

AI processing When uploading a video, it is possible to automatically create subtitles based on AI. Read more:

What is “AI Transcribe”.
If the option is enabled via auto_transcribe_audio_language: auto|, then immediately after successful transcoding, an AI task will be automatically created for transcription.
If you need to translate subtitles from original language to any other, then AI-task of subtitles translation can be applied. Use auto_translate_subtitles_language: default| parameter for that. Also you can point several languages to translate to, then a separate subtitle will be generated for each specified language.
How to “add AI-generated subtitles to an exist video”. The created AI-task(s) will be automatically executed, and result will also be automatically attached to this video as subtitle(s). Please note that transcription is done automatically for all videos uploaded to our video hosting. If necessary, you can disable automatic creation of subtitles. If AI is disabled in your account, no AI functionality is called.

Advanced Features For details on the requirements for incoming original files, and output video parameters after transcoding, refer to the Knowledge Base documentation. By default video will be transcoded according to the original resolution, and a quality ladder suitable for your original video will be applied. There is no automatic upscaling; the maximum quality is taken from the original video. If you want to upload specific files not explicitly listed in requirements or wish to modify the standard quality ladder (i.e. decrease quality or add new non-standard qualities), then such customization is possible. Please reach out to us for assistance.

Additionally, check the Knowledge Base for any supplementary information you may need.

POST

streaming

videos

curl --request POST \
  --url https://api.gcore.com/streaming/videos \
  --header 'APIKey: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "video": {
    "name": "IBC 2025 - International Broadcasting Convention",
    "description": "We look forward to welcoming you at IBC2025, which will take place 12-15 September 2025.",
    "origin_url": "https://www.googleapis.com/drive/v3/files/...?alt=media",
    "origin_http_headers": "Authorization: Bearer ...",
    "priority": 0,
    "clip_start_seconds": 137,
    "clip_duration_seconds": 60,
    "directory_id": 800,
    "projection": "regular",
    "client_user_id": 10,
    "stream_id": 1,
    "poster": "data:image/jpeg;base64,/9j/4AA...qf/2Q==",
    "screenshot_id": -1,
    "auto_transcribe_audio_language": "auto"
  }
}'

[
  {
    "id": 70575,
    "name": "Coffee Run - Blender Open Movie 720p",
    "description": "Fueled by caffeine, a young woman runs through the bittersweet memories of her past relationship. Coffee Run was directed by Hjalti Hjalmarsson and produced by the team at Blender Studio.",
    "client_id": 1,
    "duration": 184669,
    "slug": "xMbWbUSuvJ8NX2",
    "status": "ready",
    "origin_size": 29260881,
    "origin_video_duration": 184669,
    "origin_audio_channels": 2,
    "origin_height": 804,
    "origin_width": 1920,
    "created_at": "2024-06-13T12:15:25.000Z",
    "updated_at": "2024-07-26T15:30:50.000Z",
    "clip_start_seconds": null,
    "clip_duration_seconds": null,
    "hls_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.m3u8",
    "hls_cmaf_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master-cmaf.m3u8",
    "dash_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.mpd",
    "iframe_url": "https://player.gvideo.co/videos/2675_FnlHXwA16ZMxmUr",
    "poster": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "poster_thumb": "https://static.gvideo.co/videoplatform/posters/video/2474723/thumb_f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshot": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshots": [
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_1_1080.jpg",
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_2_1080.jpg"
    ],
    "screenshot_id": -1,
    "views": 2000001,
    "cdn_views": 30000003,
    "projection": "regular",
    "sprite": "https://static.gvideo.co/videoplatform/sprites/2675/2474723_FnlHXwA16ZMxmUr.mp4_sprite.jpg",
    "sprite_vtt": "1\n00:00:00,000 --> 00:00:05,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=0,0,100,42\n\n2\n00:00:05,000 --> 00:00:10,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=100,0,100,42\n\n3\n00:00:10,000 --> 00:00:15,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=200,0,100,42\n",
    "converted_videos": [
      {
        "id": 25889825,
        "name": "vod720p",
        "width": 1719,
        "height": 720,
        "size": 29929272,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3570v1_h264_1267_720.mp4"
      },
      {
        "id": 25889828,
        "name": "vod480p",
        "width": 1146,
        "height": 480,
        "size": 20827007,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3573v1_h264_800_480.mp4"
      }
    ]
  }
]

Authorizations

APIKey

string

header

required

API key for authentication.

Body

application/json

Response

200

application/json

Successful

The response is of type object[].

Get list of videos Create videos in batch

curl --request POST \
  --url https://api.gcore.com/streaming/videos \
  --header 'APIKey: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "video": {
    "name": "IBC 2025 - International Broadcasting Convention",
    "description": "We look forward to welcoming you at IBC2025, which will take place 12-15 September 2025.",
    "origin_url": "https://www.googleapis.com/drive/v3/files/...?alt=media",
    "origin_http_headers": "Authorization: Bearer ...",
    "priority": 0,
    "clip_start_seconds": 137,
    "clip_duration_seconds": 60,
    "directory_id": 800,
    "projection": "regular",
    "client_user_id": 10,
    "stream_id": 1,
    "poster": "data:image/jpeg;base64,/9j/4AA...qf/2Q==",
    "screenshot_id": -1,
    "auto_transcribe_audio_language": "auto"
  }
}'

[
  {
    "id": 70575,
    "name": "Coffee Run - Blender Open Movie 720p",
    "description": "Fueled by caffeine, a young woman runs through the bittersweet memories of her past relationship. Coffee Run was directed by Hjalti Hjalmarsson and produced by the team at Blender Studio.",
    "client_id": 1,
    "duration": 184669,
    "slug": "xMbWbUSuvJ8NX2",
    "status": "ready",
    "origin_size": 29260881,
    "origin_video_duration": 184669,
    "origin_audio_channels": 2,
    "origin_height": 804,
    "origin_width": 1920,
    "created_at": "2024-06-13T12:15:25.000Z",
    "updated_at": "2024-07-26T15:30:50.000Z",
    "clip_start_seconds": null,
    "clip_duration_seconds": null,
    "hls_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.m3u8",
    "hls_cmaf_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master-cmaf.m3u8",
    "dash_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.mpd",
    "iframe_url": "https://player.gvideo.co/videos/2675_FnlHXwA16ZMxmUr",
    "poster": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "poster_thumb": "https://static.gvideo.co/videoplatform/posters/video/2474723/thumb_f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshot": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshots": [
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_1_1080.jpg",
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_2_1080.jpg"
    ],
    "screenshot_id": -1,
    "views": 2000001,
    "cdn_views": 30000003,
    "projection": "regular",
    "sprite": "https://static.gvideo.co/videoplatform/sprites/2675/2474723_FnlHXwA16ZMxmUr.mp4_sprite.jpg",
    "sprite_vtt": "1\n00:00:00,000 --> 00:00:05,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=0,0,100,42\n\n2\n00:00:05,000 --> 00:00:10,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=100,0,100,42\n\n3\n00:00:10,000 --> 00:00:15,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=200,0,100,42\n",
    "converted_videos": [
      {
        "id": 25889825,
        "name": "vod720p",
        "width": 1719,
        "height": 720,
        "size": 29929272,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3570v1_h264_1267_720.mp4"
      },
      {
        "id": 25889828,
        "name": "vod480p",
        "width": 1146,
        "height": 480,
        "size": 20827007,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3573v1_h264_800_480.mp4"
      }
    ]
  }
]

Overview

IAM

CDN

Managed DNS

Cloud

Security

FastEdge

WAAP

Web Security

Video Streaming

Object Storage

Create video

Authorizations

Body

Response