Actions21
- Auto Caption Video Actions
- Create Video Actions
- Edit Video Actions
- File Actions
- HTML Video Actions
- Job Actions
- React Video Actions
- Template Actions
- Video Audio Actions
- Video Thumbnail Actions
Edit Video → Run Custom FFmpeg Command
AI-generatedSummary
Run a custom FFmpeg command on a provided video source to perform advanced video processing, specifying input video, output format, result retrieval method, and the exact FFmpeg command with placeholders for input and output files.
Inputs
- Video Source (required) — Paste a link to your video, or enter a file path from your storage.
- Output Format — Choose the format for your output video (MP4, MOV, WebM, MKV). Defaults to MP4.
- How to Get the Result — Select how to receive the finished result: download file directly, get a public URL, temporary download link, or save to storage only. Defaults to downloading the file.
- Link Expires After (Seconds) — If using a temporary download link, set how long the link stays active in seconds (minimum 60, maximum 86400). Default is 3600 seconds (1 hour).
- Advanced Settings -> Custom Save Path — Optional custom path to save the result in your storage. Leave empty to auto-generate.
- Command (required) — The custom FFmpeg processing command to run. Use {input} as a placeholder for the source file and {output} for the output file.
Output shape
a JSON object containing task details and the processed video result as per the selected output type
The operation sends a POST request to the endpoint /v1/video/ffmpeg-custom with the parameters. The placeholder {input} is replaced with the source video path/URL and {output} with the output file path for processing. The response varies depending on 'How to Get the Result' option: direct file download (binary), a permanent public URL, a temporary signed URL, or saved storage reference for later retrieval. Errors are thrown if unknown operations or parameters are incorrect.
Examples
Example 1: Run a custom FFmpeg command to scale a video to 640x480 and get the processed MP4 file downloaded directly.
Input the video source link, set output format to MP4, keep the output type as 'File (Default)', specify command as '-i {input} -vf "scale=640:480" {output}', then execute.