[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Encoding REST API Services

1.81.0

Added

  • Manifest generator V2 is now generally available and supports all manifest features of our API.
    • It can be used by directly setting manifest IDs in the start encoding request and setting manifestGenerator to V2.
    • We are therefore deprecating the manifest generator V2_BETA option and will remove it from our API SDKs in release v2.89.0.
    • For more information see our tutorial here.
  • Improved validation for Per-Title configurations using multiple templates with fixed resolution, fixed bitrate and bitrate selection mode COMPLEXITY_RANGE: Encodings now fail fast if the difference between the minimum or the maximum bitrate of consecutive streams is smaller than the configured minimum bitrate step size.

1.80.0

Added

  • Added support for Thumbnail Letter and Pillarboxing. Supported aspect modes: CROP, PAD, STRETCH. More Details described in the API Calls:

Fixed

  • When retrieving encodings and using the parameter search in combination with sorting by finishedAt a 500 status code was returned
  • When using an incorrect manifest ID (or one of a different type) in the Encoding Start a proper error message is returned now instead of an Internal Server Error response.

1.79.0

Added

  • IMSC as subtitle output format from TTML and SRT inputs. For TTML styling passthrough is available.
  • Warning when creating or using a H264 Configuration with settings or a preset that is not compatible with the selected profile. adaptiveSpatialTransform=true only works with profile HIGH. bframes > 0, cabac = true, and weightedPredictionPFrames = true are only working with MAIN or HIGH.

Fixed

  • For DASH manifests, containing Dolby audio renditions, the codecs attribute is not set on AdaptationSet level anymore but only on the Representation level. This also fixes a rare case of duplicate entries in the codecs attribute which could have led to device compatibility issues.

1.78.0

Added

  • Dolby Digital and Dolby Digital Plus codec configurations are now available as replacement for AC3 and EAC3.
    • We are therefore deprecating AC3 and EAC3 as the two new codec configurations are producing output, which conforms to Dolby's high certification standards.
    • Our multi-codec example now uses Dolby Digital instead of AC3.
    • For more information see our tutorial here.
  • Sprite generation no longer requires both width and height to be set, as long as one of the two values is configured, the other one is automatically computed based on the aspect ratio of the video.
  • Thumbnail creation has been extended to allow the same options with regards to height and width as sprite generation.

Changed

  • We improved the error handling and retry behaviour in case of scheduling failed. Previously unrecoverable errors could take 40 minutes to detect, which is no longer the case.

Fixed

  • Fixed LIVE encodings reporting too low (occasionally negative) statistics after a restart
  • Fixed a bug that could cause billing address changes to fail.

Known Issues

  • AdaptationSets in DASH manifests could contain the same codec multiple times in the codecs attribute, when the manifest contains a Dolby Digital, Dolby Digital Plus or a Dolby Atmos rendition.

1.77.0

Added

  • targetDurationRoundingMode property on HLS manifest, which defines the rounding mode for the target duration (normal or upward rounding) for manifests generated during the encoding.

1.76.0

Added

  • If we cannot request VM instances the api returns now more detailed error messages regarding the root cause of a "Scheduling failed" for Cloud Connect customers .

1.75.0

Added

  • If we cannot configure VM instances the api returns now more detailed error messages regarding the root cause of a "Scheduling failed" for Cloud Connect customers .

Changed

Fixed

  • Improved the SCTE35 cue tags insertion so the time frame between the cue tags is always bigger or equal to the configured cue duration.
  • Previously it was possible, that encodings started with prewarmed encoder pools did not use a prewarmed instance even though it was available
  • Fixed a concurrency issue which could lead to invalid state when calling start on prewarmed encoder pools in quick succession

1.74.0

Added

  • Added support for SCTE-35. When running a live encoding, calling this endpoint will trigger the insertion of cue tags in the provided HLS manifests and ads will be inserted.
    Note: this is an experimental feature.

Fixed

  • Fixed an issue which led to a cascade of scheduling failed error

1.73.0

Added

  • Added targetDurationRoundingMode property on HLS manifest, which defines the rounding mode for the target duration (normal or upward rounding).

Fixed

  • A validation for live edge offset in HLS Manifests introduced with v1.72.0 could falsely fail, if a CC caption has been used as media stream.
  • Fixed incorrect audio manifest relative path when generating audio-only HLS manifest with MP4 muxing.

1.72.0

Changed

  • Improved stability for encodings on Google Cloud.

Fixed

  • Added validation for Live Edge Offset in HLS Manifests: Live Edge Offset now has to be >= than the segment length of their assigned muxing
  • Fixed concurrency issue for manifest status updates from encoders (introduced in Encoder v2.75.0) that could lead to inconsistent status
  • Fixed manifest status endpoints (DASH, HLS and Smooth ) to return a spec conform servicetask property.

Give us feedback