This endpoint allows you to add an audio or subtitle track to an existing media file using its mediaId
. You need to provide the track url
along with its type
(audio or subtitle), languageName
and languageCode
in the request payload.
How it works
-
Send a POST request to this endpoint, replacing
{mediaId}
with the media ID (uploadId
orid
). -
Provide the necessary details in the request body.
-
Receive a response containing a unique track ID and the details of the newly added track.
Webhook events
-
After successfully adding a track, your system will receive the webhook event video.media.track.created.
-
Once the track is processed and ready, you will receive the webhook event video.media.track.ready.
-
Finally, an update event video.media.updated will notify your system about the media's updated status.
Example
Suppose you have a video uploaded to the FastPix platform, and you want to add an Italian audio track to it. By calling this API, you can attach an external audio file (https://static.fastpix.io/music-1.mp3) to the media file. Similarly, if you need to add subtitles in different languages, you can specify type: subtitle
with the corresponding subtitle url
, languageCode
and languageName
.
Related guides: Add own subtitle tracks, Add own audio tracks