Record a specific output rendition

Learn how to use the REST API to record a specific output rendition for a transcoder. This allows you to include a watermark if the transcoder has one enabled. It also allows you to determine the quality of the recording by selecting a particular output rendition.

Before you start


You should complete the following tasks:

  • Create a transcoder with output renditions. You'll need the resulting transcoder_id to record a broadcast and the output_id if you would like to record a specific output rendition. View our Connect a source topics to learn how to create a transcoder for RTMP, RTSP, IP camera, SRT encoder, UDP encoder, WebRTC, and Wowza Streaming Engine.

You should be familiar with the following concepts:

Record a specific output rendition


Configure the transcoder to record a specific output rendition by setting the record transcoder output property to a specific output ID. 

  1. Set the record transcoder property to the output ID for the output rendition you want to record.

    You can only record one output of a transcoder. If you specify a passthrough output as the recording source, Wowza Streaming Cloud uses the source stream from the encoder for the recording.

    curl -X POST \
    -H "Content-Type: application/json" \
    -H "wsc-api-key: ${WSC_API_KEY}" \
    -H "wsc-access-key: ${WSC_ACCESS_KEY}" \
    -d '{
       "property": {
         "key": "record",
         "section": "output",
         "value": "[output_id]"
       } 
    }' "${WSC_HOST}/api/${WSC_VERSION}/transcoders/[transcoder_id]/properties"
  2. If you have started a transcoder at any point before updating its transcoder property, you must reset the transcoder for the property to take effect. This step isn’t necessary if you haven’t started the transcoder at all.

    curl -X PUT \
    -H "wsc-api-key: ${WSC_API_KEY}" \
    -H "wsc-access-key: ${WSC_ACCESS_KEY}" \ 
    "${WSC_HOST}/api/${WSC_VERSION}/transcoders/[transcoder_id]/reset"


    The transcoder is now configured to record the specified output rendition.

Next steps