Variants

Add a track-specific variant

Appends a new track file to an already-processed track and queues processing. Only 'transcode' and 'preview' are supported. Common body fields: variant_type_id, index. Transcode fields: codec, bitrate, is_stereo, is_strip_tags, is_strip_cover (lossy codecs only; codec defaults to aac at 128 kbps). Preview fields: preview_type, preview_seconds / preview_min_percent / preview_max_percent (when preview_type is seconds), preview_percent / preview_min_seconds / preview_max_seconds (when preview_type is percent), preview_start_percent — plus the same Transcode audio fields. The track is moved to 'processing' and returns to 'ready' when the file is generated.

post/v1/track/{track_id}/variant

Request

  • Base URL: https://api.audiodelivery.net
  • URL: https://api.audiodelivery.net/v1/track/{track_id}/variant
  • Auth: HTTP bearer

Path parameters

track_idstring uuid required

Request body

variant_type_id'transcode' | 'preview' required
indexstring required

Delivery name; unique across organization and track variants

codec'aac' | 'mp3' | 'ogg' | 'opus'
bitrateinteger
is_stereoboolean
is_strip_tagsboolean
is_strip_coverboolean
preview_type'seconds' | 'percent'

preview only

preview_secondsnumber

preview + preview_type 'seconds'

preview_min_percentnumber

preview + preview_type 'seconds'

preview_max_percentnumber

preview + preview_type 'seconds'

preview_percentnumber

preview + preview_type 'percent'

preview_min_secondsnumber

preview + preview_type 'percent'

preview_max_secondsnumber

preview + preview_type 'percent'

preview_start_percentnumber

preview only: clip start as a percent of duration

Response

Variant created and processing queued.

oktrue required
api_request_idstring uuid required
track_idstring uuid
variant_idstring uuid
job_idstring uuid

Changes

No recorded changes to this operation across all 1 revision of this API.