Overview
IAM
- Account
- Users
- API Tokens
CDN
- IP addresses list
- CDN service
- Origins
- CDN resources
- CDN activity logs
- Log forwarding
- Log viewer
- Logs uploader
- Tools
- Rules
- Rule templates
- Purge history
- SSL certificates
- CA certificates
- CDN Statistics
- Advanced analytics
- Origin shielding
- Let's Encrypt certificates
Managed DNS
- Analyze
- Locations
- Lookup
- Metrics
- Pickers
- DNS Clients
- Zones
- DNSSEC
- RRsets
Cloud
- Bare Metal
- Container as a Service
- Cost Reports
- DDOS Protection
- File Shares
- Firewalls
- Floating IPs
- Function as a Service
- GPU Cloud
- IP Ranges
- Images
- Inference Instances
- Instances
- Load Balancers
- Logging
- Managed Kubernetes
- Managed PostgreSQL
- Networks
- Placement Groups
- Projects
- Quotas
- Regions
- Registry
- Reservations
- Reserved IPs
- Routers
- SSH Keys
- Secrets
- Service Endpoints
- Snapshot Schedules
- Snapshots
- Tasks
- User Actions
- User Role Assignments
- Volumes
Security
- Event Logs
- BGP announces
- Security Templates
- Profiles
FastEdge
- Apps
- Binaries
- FastEdge Clients
- FastEdge Secrets
- Stats
- FastEdge Templates
WAAP
- WAAP Service
- Domains
- Policies
- Analytics
- Custom Page Sets
- Custom Rules
- Firewall Rules
- Advanced Rules
- Tags
- Network Organizations
- API Discovery
- IP Spotlight
- Security Insights
Web Security
- Billing Statistics
- Resources
Video Streaming
- Streams
- Overlays
- Broadcasts
- Restreams
- Videos
- Subtitles
- Directories
- Playlists
- QualitySets
- Players
- AI
- Streaming Statistics
Object Storage
- Notifications
- Key
- Location
- Storage
- Storage Statistics
Create videos in batch
Mass upload of your videos. Method is used to set the task of creating videos in the form of 1 aggregated request instead of a large number of single requests.
An additional advantage is the ability to specify subtitles in the same request. Whereas for a normal single upload, subtitles are uploaded in separate requests.
All videos in the request will be processed in queue in order of priority. Use “priority” attribute and look at general description in POST /videos method. Limits:
- Batch max size = 500 videos.
- Max body size (payload) = 64MB.
- API connection timeout = 30 sec.
curl --request POST \
--url https://api.gcore.com/streaming/videos/batch \
--header 'APIKey: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"videos": [
{
"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",
"subtitles": [
{
"name": "English (AI-generated)",
"language": "eng",
"vtt": "WEBVTT\n\n1\n00:00:07.154 --> 00:00:12.736\nWe have 100 million registered users or active users who play at least once a week.\n\n2\n00:00:13.236 --> 00:00:20.198\nWe might have 80 or 100,000 playing on a given cluster."
},
{
"name": "German (AI-translated)",
"language": "ger",
"vtt": "WEBVTT\n\n1\n00:00:07.154 --> 00:00:12.736\nWir haben 100 Millionen registrierte Benutzer oder aktive Benutzer, die mindestens einmal pro Woche spielen.\n\n2\n00:00:13.236 --> 00:00:20.198\nWir haben vielleicht 80 oder 100.000, die auf einem bestimmten Cluster spielen."
}
]
}
]
}'
[
{
"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
API key for authentication.
Query Parameters
Restriction to return only the specified attributes, instead of the entire dataset. Specify, if you need to get short response. The following fields are available for specifying: id, name, duration, status, created_at
, updated_at
, hls_url
, screenshots, converted_videos
, priority. Example, ?fields=id,name,hls_url
Body
Response
Successful
The response is of type object[]
.
Was this page helpful?
curl --request POST \
--url https://api.gcore.com/streaming/videos/batch \
--header 'APIKey: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"videos": [
{
"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",
"subtitles": [
{
"name": "English (AI-generated)",
"language": "eng",
"vtt": "WEBVTT\n\n1\n00:00:07.154 --> 00:00:12.736\nWe have 100 million registered users or active users who play at least once a week.\n\n2\n00:00:13.236 --> 00:00:20.198\nWe might have 80 or 100,000 playing on a given cluster."
},
{
"name": "German (AI-translated)",
"language": "ger",
"vtt": "WEBVTT\n\n1\n00:00:07.154 --> 00:00:12.736\nWir haben 100 Millionen registrierte Benutzer oder aktive Benutzer, die mindestens einmal pro Woche spielen.\n\n2\n00:00:13.236 --> 00:00:20.198\nWir haben vielleicht 80 oder 100.000, die auf einem bestimmten Cluster spielen."
}
]
}
]
}'
[
{
"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"
}
]
}
]