Just-in-time serverless ad conformance service that transcodes an ad from its master format into a streaming format matching the primary content stream. 9 paths / 12 operations, authenticated with an x-rasp-auth-token API key.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/optiview-ad-engine"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.0.3
info:
title: Dolby OptiView Ad Engine
version: 1.0.0
servers:
- url: https://api.galaxy.dolbyrasp.com
paths:
/ad-engine/profile:
post:
operationId: create-ad-profile
tags:
- Ad Engine
summary: Create Ad Profile
description: Creates an ad encoding profile.
responses:
'200':
description: OK
requestBody:
required: true
content:
application/json:
schema:
$id: http://dolbyrasp.com/schemas/apigw/dae.profile.body
type: object
properties:
source_options:
type: object
properties:
trim:
type: object
properties:
inpoint_sec:
type: number
minimum: 0
description: The starting point in seconds for the trim.
duration_sec:
type: number
exclusiveMinimum: 0
description: The duration in seconds for the trim.
additionalProperties: false
description: Object defining the trim to be applied to the source asset.
additionalProperties: false
x-docs-hide: true
encode_profile:
type: object
required:
- container
properties:
container:
type: object
required:
- kind
properties:
kind:
enum:
- hls
- hls/fmp4
- mpegts
- mpeg2ts
- mp4
- m4a
- fmp4
- m4s
- wav
- nut
description: The type of media container for the output.
use_editlist:
type: boolean
description: This sets the edit list atom (elst) in MP4 files. Read more here https://developer.apple.com/documentation/quicktime-file-format/edit_list_atom.
The default is false.
mpegts_initial_discontinuity:
type: boolean
default: false
segment_duration_sec:
type: number
description: The segment duration in seconds for segmented or fragmented streams such as HLS or
mp4/MPEG-DASH. Decimal notation (e.g. 5.5) is supported.
prefetch_hint_sec:
type: number
description: This determines how much to encode ahead of the current time during playback. It can
be separately determined for the audio and video streams.
additionalProperties: false
video:
anyOf:
- type: object
properties:
id:
type: string
description: An ID for the video layer.
width:
type: integer
description: Width of the output video.
height:
type: integer
description: Height of the output video.
bitrate_kb:
type: integer
description: The video bitrate in kilobits per second. For vbr, this is the average bitrate.
frame_rate:
oneOf:
- type: string
pattern: ^\d+\.?,?\/?\d+$
- type: number
description: 'The video frame rate - can be expressed in decimal or fraction notation, examples:
29.97, 30000/1001'
codec:
enum:
- h264
- h265
description: The desired output video codec.
chroma_format:
type: string
description: The chroma format.
color_primaries:
enum:
- bt601
- smpte170m
- bt709
- bt470m
- bt470bg
- smpte240m
- film
- bt2020
- smpte428
- smpte431
- smpte432
- jedec-p22
description: Chroma coordinate reference of the source primaries. The default is determined by
video size.
color_trc:
enum:
- bt601
- smpte170m
- bt709
- gamma22
- bt470m
- gamma28
- bt470bg
- smpte240m
- smpte428
- linear
- log
- log_sqrt
- bt1361
- smpte2084
- iec61966_2_1
- iec61966_2_4
- bt2020_10bit
- bt2020_12bit
- hlg
- arib-std-b67
description: Color transfer characteristics. The default determined by video size.
color_matrix:
enum:
- rgb
- bt470bg
- bt709
- smpte170m
- smpte240m
- ycgco
- bt2020c
- bt2020nc
- smpte2085
- chroma-derived-nc
- chroma-derived-c
- ictcp
- fcc
description: YUV/YCbCr colorspace type.
ire_range_mode:
enum:
- full
- limited
- auto
description: The IRE range for the source video. The default is auto.
range:
enum:
- sdr
- dolby_vision_5
- dolby_vision_8.1
- hdr10
description: The color range of the output video. The default is sdr.
sdr_enhancement:
type: object
properties:
mode:
enum:
- simple
- lut_low
- lut_med
- lut_high
default: lut_med
description: The conversion stregth of the SDR to HDR conversion 3D LUT.
use_metadata_smoothing:
type: boolean
default: true
description: Flag to smooth the HDR metadata between encoding segments.
additionalProperties: false
description: Object defining SDR to HDR enhancement controls.
abr_map:
type: object
properties:
hls_audio_group:
type: string
description: The HLS group that this layer belongs to.
compatibility_group:
type: string
description: The compatibility group that this layer belongs to.
additionalProperties: false
description: Object with parameters controlling HLS audio layer affinities.
dar:
oneOf:
- type: string
pattern: ^\d+\.?:?\/?\d+$
- type: number
description: 'The display aspect ratio. May expressed in decimal or fraction notation, examples:
1.33, 4/3'
sar:
oneOf:
- type: string
pattern: ^\d+\.?:?\/?\d+$
- type: number
description: The storage aspect ratio. May expressed in decimal or fraction notation. The storage
aspect ratio, display aspect ratio, and pixel aspect ratio are related by DAR = SAR x PAR
force_original_aspect_ratio:
type: boolean
description: This will force the output to have the same aspect ratio as the input.
profile:
type: string
description: The profile for your codec. Not all profiles are valid for all codecs.
level:
type: string
description: The codec-dependent level - please reference ISO/IEC 14496-10, ISO/IEC 13818-2 etc.
preset:
type: string
description: Codec preset. See https://trac.ffmpeg.org/wiki/Encode/H.264 for examples.
max_bitrate_kb:
type: number
description: The maximum video bitrate in kilobits per second. Only valid for crf and vbr.
min_bitrate_kb:
type: number
description: The minimum video bitrate in kilobits per second. Only valid for crf and vbr.
vbv_buffer_size_kb:
type: number
description: The vbv buffer size in kilobits.
vbv_init_occupancy_kb:
type: number
description: The vbv init occupancy in kilobits.
exact_gop_frames:
type: integer
description: Use a fixed GOP size of this many frames.
idr_interval:
type: object
properties:
seconds:
type: number
description: Describes IDR frame interval in seconds.
frames:
type: integer
description: Describes IDR frame interval in frames.
additionalProperties: false
description: Describes a IDR frame interval, as count or seconds.
refs:
type: integer
description: The number of h.264 reference frames to used for future frames. If not set, the profile/level
combination will determine the proper number of reference frames.
use_scene_detection:
type: boolean
description: Enable or disable scene change detection. Disabling will come with a steep penalty
on video quality.
use_closed_gop:
type: boolean
description: Force use of closed GOPs.
bitrate_mode:
type: string
description: The bitrate mode for the codec. Values include cbr, vbr, and crf.
crf:
type: number
description: If the bitrate mode is crf, then this value must be specified. A Constant Rate Factor
setting of 18 is considered excellent. Higher values equal lower quality. A change of +6 should
roughly halve the resulting file size. See https://trac.ffmpeg.org/wiki/Encode/H.264
use_sequence_header_per_gop:
type: boolean
description: This will write a sequence header for each GOP.
closed_captions:
type: object
properties:
suppress:
type: boolean
enum:
- true
description: Suppress including captions in the output.
additionalProperties: false
description: Object describing the CC parameters for the targeted output.
track_selector:
type: object
additionalProperties: true
x-docs-hide: true
prefetch_hint_sec:
type: number
description: This determines how much to encode ahead of the current time during playback. It
can be separately determined for the audio and video streams.
x264_options:
type: string
description: x.264 specific codec options - please reference https://ffmpeg.org/ffmpeg-codecs.html#toc-libx264_002c-libx264rgb
filters:
type: array
title: Video Filters
description: The array of video filters to be applied to the output.
items:
type: object
description: The video filter object with a specific kind and payload format.
required:
- kind
- payload
oneOf:
- $ref: '#/components/schemas/Filter_image_overlay'
- $ref: '#/components/schemas/Filter_video_overlay'
- $ref: '#/components/schemas/Filter_text_overlay'
discriminator:
propertyName: kind
mapping:
image_overlay: '#/components/schemas/Filter_image_overlay'
video_overlay: '#/components/schemas/Filter_video_overlay'
text_overlay: '#/components/schemas/Filter_text_overlay'
additionalProperties: false
description: The video encoding parameters.
- type: array
items:
type: object
properties:
id:
type: string
description: An ID for the video layer.
width:
type: integer
description: Width of the output video.
height:
type: integer
description: Height of the output video.
bitrate_kb:
type: integer
description: The video bitrate in kilobits per second. For vbr, this is the average bitrate.
frame_rate:
oneOf:
- type: string
pattern: ^\d+\.?,?\/?\d+$
- type: number
description: 'The video frame rate - can be expressed in decimal or fraction notation, examples:
29.97, 30000/1001'
codec:
enum:
- h264
- h265
description: The desired output video codec.
chroma_format:
type: string
description: The chroma format.
color_primaries:
enum:
- bt601
- smpte170m
- bt709
- bt470m
- bt470bg
- smpte240m
- film
- bt2020
- smpte428
- smpte431
- smpte432
- jedec-p22
description: Chroma coordinate reference of the source primaries. The default is determined
by video size.
color_trc:
enum:
- bt601
- smpte170m
- bt709
- gamma22
- bt470m
- gamma28
- bt470bg
- smpte240m
- smpte428
- linear
- log
- log_sqrt
- bt1361
- smpte2084
- iec61966_2_1
- iec61966_2_4
- bt2020_10bit
- bt2020_12bit
- hlg
- arib-std-b67
description: Color transfer characteristics. The default determined by video size.
color_matrix:
enum:
- rgb
- bt470bg
- bt709
- smpte170m
- smpte240m
- ycgco
- bt2020c
- bt2020nc
- smpte2085
- chroma-derived-nc
- chroma-derived-c
- ictcp
- fcc
description: YUV/YCbCr colorspace type.
ire_range_mode:
enum:
- full
- limited
- auto
description: The IRE range for the source video. The default is auto.
range:
enum:
- sdr
- dolby_vision_5
- dolby_vision_8.1
- hdr10
description: The color range of the output video. The default is sdr.
sdr_enhancement:
type: object
properties:
mode:
enum:
- simple
- lut_low
- lut_med
- lut_high
default: lut_med
description: The conversion stregth of the SDR to HDR conversion 3D LUT.
use_metadata_smoothing:
type: boolean
default: true
description: Flag to smooth the HDR metadata between encoding segments.
additionalProperties: false
description: Object defining SDR to HDR enhancement controls.
abr_map:
type: object
properties:
hls_audio_group:
type: string
description: The HLS group that this layer belongs to.
compatibility_group:
type: string
description: The compatibility group that this layer belongs to.
additionalProperties: false
description: Object with parameters controlling HLS audio layer affinities.
dar:
oneOf:
- type: string
pattern: ^\d+\.?:?\/?\d+$
- type: number
description: 'The display aspect ratio. May expressed in decimal or fraction notation, examples:
1.33, 4/3'
sar:
oneOf:
- type: string
pattern: ^\d+\.?:?\/?\d+$
- type: number
description: The storage aspect ratio. May expressed in decimal or fraction notation. The storage
aspect ratio, display aspect ratio, and pixel aspect ratio are related by DAR = SAR x PAR
force_original_aspect_ratio:
type: boolean
description: This will force the output to have the same aspect ratio as the input.
profile:
type: string
description: The profile for your codec. Not all profiles are valid for all codecs.
level:
type: string
description: The codec-dependent level - please reference ISO/IEC 14496-10, ISO/IEC 13818-2
etc.
preset:
type: string
description: Codec preset. See https://trac.ffmpeg.org/wiki/Encode/H.264 for examples.
max_bitrate_kb:
type: number
description: The maximum video bitrate in kilobits per second. Only valid for crf and vbr.
min_bitrate_kb:
type: number
description: The minimum video bitrate in kilobits per second. Only valid for crf and vbr.
vbv_buffer_size_kb:
type: number
description: The vbv buffer size in kilobits.
vbv_init_occupancy_kb:
type: number
description: The vbv init occupancy in kilobits.
exact_gop_frames:
type: integer
description: Use a fixed GOP size of this many frames.
idr_interval:
type: object
properties:
seconds:
type: number
description: Describes IDR frame interval in seconds.
frames:
type: integer
description: Describes IDR frame interval in frames.
additionalProperties: false
description: Describes a IDR frame interval, as count or seconds.
refs:
type: integer
description: The number of h.264 reference frames to used for future frames. If not set, the
profile/level combination will determine the proper number of reference frames.
use_scene_detection:
type: boolean
description: Enable or disable scene change detection. Disabling will come with a steep penalty
on video quality.
use_closed_gop:
type: boolean
description: Force use of closed GOPs.
bitrate_mode:
type: string
description: The bitrate mode for the codec. Values include cbr, vbr, and crf.
crf:
type: number
description: If the bitrate mode is crf, then this value must be specified. A Constant Rate
Factor setting of 18 is considered excellent. Higher values equal lower quality. A change
of +6 should roughly halve the resulting file size. See https://trac.ffmpeg.org/wiki/Encode/H.264
use_sequence_header_per_gop:
type: boolean
description: This will write a sequence header for each GOP.
closed_captions:
type: object
properties:
suppress:
type: boolean
enum:
- true
description: Suppress including captions in the output.
additionalProperties: false
description: Object describing the CC parameters for the targeted output.
track_selector:
type: object
additionalProperties: true
x-docs-hide: true
prefetch_hint_sec:
type: number
description: This determines how much to encode ahead of the current time during playback. It
can be separately determined for the audio and video streams.
x264_options:
type: string
description: x.264 specific codec options - please reference https://ffmpeg.org/ffmpeg-codecs.html#toc-libx264_002c-libx264rgb
filters:
type: array
title: Video Filters
description: The array of video filters to be applied to the output.
items:
type: object
description: The video filter object with a specific kind and payload format.
required:
- kind
- payload
oneOf:
- $ref: '#/components/schemas/Filter_image_overlay'
- $ref: '#/components/schemas/Filter_video_overlay'
- $ref: '#/components/schemas/Filter_text_overlay'
discriminator:
propertyName: kind
mapping:
image_overlay: '#/components/schemas/Filter_image_overlay'
video_overlay: '#/components/schemas/Filter_video_overlay'
text_overlay: '#/components/schemas/Filter_text_overlay'
additionalProperties: false
description: The video encoding parameters.
audio:
type: array
items:
type: object
properties:
id:
type: string
description: ID of the audio track.
program_name:
type: string
description: Program name of the audio track.
codec:
enum:
- aac
- aac_lc
- he_aac1
- he_aac2
- ac4
- ddp_joc
description: The audio codec to use for the track.
bitrate_kb:
type: number
description: The audio bitrate in kilobits per second. This is the average bitrate in the case
of vbr.
channels:
type: integer
description: The number of audio channels.
sample_rate:
type: integer
description: The audio sample rate in Hz. Typical values are 44100 and 48000. Omit to use the
source sample rate.
auto_generate_silence_track:
type: boolean
description: 'This fills the track with silence. '
filters:
type: array
title: Audio Filters
description: The array of audio filters to be applied to the output.
items:
type: object
description: The audio filter object with a specific kind and payload format.
required:
- payload
oneOf:
- $ref: '#/components/schemas/Filter_normalize'
discriminator:
propertyName: kind
mapping:
normalize: '#/components/schemas/Filter_normalize'
language:
# --- truncated at 32 KB (622 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dolby/refs/heads/main/openapi/dolby-optiview-ad-engine-openapi.yml