Configure transcoding output for your use case - streaming, archival, or web delivery.
Quick Example from videodb import TranscodeMode, VideoConfig, AudioConfig, ResizeMode job_id = conn.transcode( source = "https://example.com/source.mov" , callback_url = "https://your-backend.com/webhooks" , mode = TranscodeMode.lightning, video_config = VideoConfig( resolution = 720 , quality = 23 , framerate = 30 , resize_mode = ResizeMode.fit ), audio_config = AudioConfig( mute = False ) )
Format Use Case MP4 Download, archival, playback HLS Adaptive streaming, web players
Resolution Options Resolution Dimensions Use Case 360p (SD) 640 × 360 Mobile, low bandwidth 720p (HD) 1280 × 720 General web delivery 1080p (FHD) 1920 × 1080 High quality streaming
VideoConfig Field Type Default Notes resolutionint 720 Height in pixels (auto-calculates width) qualityint 23 CRF (lower = better quality, larger file) framerateint Source Target framerate (max 100 fps) aspect_ratiostr Source e.g., “16:9”, “1:1”, None for original resize_modeResizeMode crop How to handle aspect ratio changes
Quality Presets (CRF) Quality CRF Range Use Case Visually Lossless 18–20 Archival, editing source Good Quality 21–23 General delivery Lower Quality 24–28 Web previews, thumbnails
Lower CRF = better quality but larger file size. Default 23 is a good balance.
Framerate Supported: 30fps and 60fps output.
VideoConfig( resolution = 720 , framerate = 30 # or 60 )
Aspect Ratio Control ResizeMode Mode Behavior Visual cropCrop edges to fill target No black bars, content may be cut fitScale uniformly May letterbox (black bars) padAdd black bars Content preserved, bars added
from videodb import ResizeMode, VideoConfig # Crop to fill (may lose edges) VideoConfig( aspect_ratio = "16:9" , resize_mode = ResizeMode.crop) # Fit with letterbox VideoConfig( aspect_ratio = "16:9" , resize_mode = ResizeMode.fit) # Pad with black bars VideoConfig( aspect_ratio = "1:1" , resize_mode = ResizeMode.pad)
AudioConfig Field Type Default Notes mutebool false true removes audio track
from videodb import AudioConfig # Keep audio AudioConfig( mute = False ) # Remove audio AudioConfig( mute = True )
Common Configurations Web Delivery (720p, optimized) VideoConfig( resolution = 720 , quality = 23 , framerate = 30 , resize_mode = ResizeMode.fit )
VideoConfig( resolution = 720 , aspect_ratio = "1:1" , resize_mode = ResizeMode.crop )
Archival (High Quality) VideoConfig( resolution = 1080 , quality = 18 , framerate = 60 )
Mobile Preview (Low Bandwidth) VideoConfig( resolution = 360 , quality = 28 , framerate = 30 )
Job Output Details Completed jobs include detailed metadata:
{ "job_id" : "xxx" , "status" : "completed" , "output" : "https://transcoded-output.mp4" , "input_details" : { "resolution" : "1920x1080" , "framerate" : 30 , "duration" : 634.53 , "size" : 263.34 , "video_codec" : "h264" , "audio_codec" : "mp3" }, "output_details" : { "resolution" : "1920x1080" , "framerate" : 30 , "duration" : 635.06 , "size" : 253.84 , "format" : "mp4" , "video_codec" : "h264" , "audio_codec" : "aac" }, "cost" : 0.1058 }
Next Steps
When to Transcode Decision guide and processing modes
Upload Video Ingest media into VideoDB
