Configuration
Compressed-video workflow configuration has two layers:
- Container runtime settings, such as ports and concurrency.
- Request settings, such as codec, target resolution, stream type, and quality preset.
Container Runtime Settings
The VSR NIM image includes reserved environment variables that must remain at their default values. You can use other environment variables to tune the container runtime.
Reserved Environment Variables
The following two variables are part of the released NIM image configuration. Docker permits overriding them with -e VAR=..., but changing either setting can prevent the service from starting. Leave them at their defaults.
Do not pass -e NIM_DISABLE_MODEL_DOWNLOAD=... or -e NIM_DISABLE_GRPC_STARTUP=... on docker run.
User-Tunable Environment Variables
The following environment variables can be used when starting the VSR NIM container:
When overriding the HTTP or gRPC port, publish the matching container port:
If you use the reference client scripts, update nim_service_host and nim_grpc_port in config/client_config.sh so that the client connects to the right address and port.
Request Configuration
Edit the JSON files in samples/client/vsr/ to configure each request.
Example gRPC request configuration:
Required Fields
Stream Types
Codecs
Compressed-video workflows support the following codec enum values:
VIDEO_CODEC_H264VIDEO_CODEC_HEVCVIDEO_CODEC_AV1
The VSR pipeline supports 4:2:0 and 4:2:2 chroma. The actual decodable set depends on the NVDEC capabilities of the host GPU.
Quality Presets
If the quality preset is not specified, VSR defaults to VIDEO_QUALITY_HIGH.
Resolution Limits
- Input width:
192to4096. - Input height:
128to4096. - Maximum scale ratio: 4x per dimension.
- H.264 output: up to
4096 x 4096. - HEVC and AV1 output: up to
8192 x 8192.