Transcode Settings

Returns the transcode configuration settings.

Request

Property	Value
Method	`GET`
URL	`/api/transcode/settings`
Content-Type	`application/json`
Authentication	Bearer Token

Request

bash

curl -X GET "{BASE_URL}/api/transcode/settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Body

Transcode Settings

Parameter	Type	Description
`data.attributes.ffmpegPath.value`	string	Path to the ffmpeg executable
`data.attributes.ffmpegPath.editable`	boolean	Indicates if the field can be modified
`data.attributes.ffmpegPath.lockedBy`	string	Locked by environment variable (if present)
`data.attributes.ffmpegCommand.value`	string	FFmpeg command template
`data.attributes.ffmpegCommand.editable`	boolean	Indicates if the field can be modified
`data.attributes.ffmpegCommand.lockedBy`	string	Locked by environment variable (if present)
`data.attributes.transcodeTaskLimit.value`	integer	Maximum number of concurrent transcode tasks
`data.attributes.transcodeTaskLimit.editable`	boolean	Indicates if the field can be modified
`data.attributes.transcodeTaskLimit.lockedBy`	string	Locked by environment variable (if present)
`data.attributes.thumbGenerateTaskLimit.value`	integer	Maximum number of concurrent thumbnail generation tasks
`data.attributes.thumbGenerateTaskLimit.editable`	boolean	Indicates if the field can be modified
`data.attributes.thumbGenerateTaskLimit.lockedBy`	string	Locked by environment variable (if present)

FFmpeg Command Placeholders

Placeholder	Description
`{SOURCE_INPUT}`	Source stream input URL
`{VIDEO_ENCODER}`	Video encoder
`{AUDIO_ENCODER}`	Audio encoder
`{STREAM_OUTPUT}`	Output stream destination URL

Metadata

Parameter	Type	Description
`meta.executionTime`	integer	Request processing time in milliseconds
`meta.generatedAt`	integer	Response generation timestamp (Unix timestamp in ms)

Successful Response (200)

json

{
  "data": {
    "attributes": {
      "ffmpegPath": {
        "editable": true,
        "value": "ffmpeg"
      },
      "ffmpegCommand": {
        "editable": true,
        "value": "-re -nostdin -i {SOURCE_INPUT} {VIDEO_ENCODER} {AUDIO_ENCODER} -f flv {STREAM_OUTPUT}"
      },
      "transcodeTaskLimit": {
        "editable": true,
        "value": 5
      },
      "thumbGenerateTaskLimit": {
        "editable": true,
        "value": 2
      }
    }
  },
  "meta": {
    "executionTime": 0,
    "generatedAt": 1765791166659
  }
}

Error Response (4xx/5xx)

Parameter	Type	Description
`message`	string	Human-readable error message

json

{
  "message": "Error message"
}

Support Needed?

Create a free ticket and our support team will provide you necessary assistance.