Encoding FiltersUpdate Encoding Filter

Update Encoding Filter

Edit an existing transcoding profile filter.

curl -X POST "https://api.5centscdn.com/v2/transcoding/filters/3" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "name": "flutter",
  "filter": "drawtext",
  "args[overlay][url]": "https://cdn.example.com/logo.png",
  "args[overlay][scale]": "10",
  "args[overlay][position]": "top_right",
  "args[text]": "© 2024 My Brand",
  "args[fontsize]": 24,
  "args[fontcolor]": "#FFFFFF",
  "args[position]": "top_left"
}'
{
  "result": "success",
  "message": "Transcoding Settings Updated"
}
POST
/transcoding/filters/{filterid}
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

path
filteridinteger
Required

ID of the Transcoding Filter (fs_transcodefilters.id).

Content-Typestring
Required

The media type of the request body

Options: application/json
namestring

The name associated with the configuration or filter.

filterstring

Filter category. overlay = apply image/logo watermark. drawtext = render text overlay on video.

Options: overlay, drawtext
args[overlay][url]string

Public HTTP/HTTPS URL of the watermark image. PNG recommended for transparency. Required when filter=overlay.

args[overlay][scale]string

Watermark image size as a percentage of the output video frame width. Required when filter=overlay.

args[overlay][position]string

Position of the watermark on the video frame.

Options: top_left, top_right, bottom_left, bottom_right, center
args[text]string

Text string to render as overlay on video. Required when filter=drawtext.

args[fontsize]integer

Font size of text overlay in pixels. Required when filter=drawtext.

args[fontcolor]string

Color of text overlay. Accepts CSS hex (#RRGGBB) or FFmpeg named colors. Required when filter=drawtext.

args[position]string

Position of the text overlay on the video frame.

Options: top_left, top_right, bottom_left, bottom_right, center
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

filteridinteger
Required

ID of the Transcoding Filter (fs_transcodefilters.id).

Example:
3

Body

application/json
namestring

The name associated with the configuration or filter.

Example:
flutter
filterstring

Filter category. overlay = apply image/logo watermark. drawtext = render text overlay on video.

Allowed values:overlaydrawtext
args[overlay][url]string

Public HTTP/HTTPS URL of the watermark image. PNG recommended for transparency. Required when filter=overlay.

Example:
https://cdn.example.com/logo.png
args[overlay][scale]string

Watermark image size as a percentage of the output video frame width. Required when filter=overlay.

Example:
10
args[overlay][position]string

Position of the watermark on the video frame.

Allowed values:top_lefttop_rightbottom_leftbottom_rightcenter
args[text]string

Text string to render as overlay on video. Required when filter=drawtext.

Example:
© 2024 My Brand
args[fontsize]integer

Font size of text overlay in pixels. Required when filter=drawtext.

Example:
24
args[fontcolor]string

Color of text overlay. Accepts CSS hex (#RRGGBB) or FFmpeg named colors. Required when filter=drawtext.

Example:
#FFFFFF
args[position]string

Position of the text overlay on the video frame.

Allowed values:top_lefttop_rightbottom_leftbottom_rightcenter

Responses

resultstring

API response status.

messagestring

Human-readable result or error message.