Endpoint Examples
Poll FFmpeg Command
Get the status of a previously submitted FFmpeg command.
GET
/
v1
/
commands
/
{command_id}
curl --request GET \
--url https://api.rendi.dev/v1/commands/{command_id} \
--header 'X-API-KEY: <api-key>'
{
"command_id": "123e4567-e89b-12d3-a456-426614174000",
"ffmpeg_command_run_seconds": 19.58051347732544,
"original_request": {
"ffmpeg_command": "-i {{in_1}} -ss 00:00 -to 00:30 -filter_complex [0:v]split=2[vid1][vid2];[vid1]scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1[320p];[vid2]scale=trunc(oh*a/2)*2:180:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:180:-1:-1[180p] -map [320p] -map 0:a -c:a copy -c:v libx264 -preset medium {{out_1}} -map [180p] -map 0:a -c:a copy -c:v libx264 -preset medium {{out_2}}",
"input_files": {
"in_1": "https://storage.rendi.dev/sample/sample.avi"
},
"max_command_run_seconds": 300,
"output_files": {
"out_1": "output_320p.mp4",
"out_2": "output_180p.mp4"
}
},
"output_files": {
"out_1": {
"bitrate_audio_kb": 242.349609375,
"bitrate_video_kb": 370.5654296875,
"codec": "h264",
"duration": 30,
"file_format": "mp4",
"file_id": "f775b15d-67e9-4235-b89f-4bb33c0a5f57",
"file_type": "video",
"frame_rate": 24,
"height": 320,
"is_varying_frame_rate": false,
"size_mbytes": 2.2677812576293945,
"storage_url": "https://storage.rendi.dev/temp_files/224ea098-5c10-419b-8a77-707d89443c56/42c95292-d953-4b5a-8a58-cf1513363a33/output_320p.mp4",
"width": 568
},
"out_2": {
"bitrate_audio_kb": 239.9833984375,
"bitrate_video_kb": 160.955078125,
"codec": "h264",
"duration": 596.459,
"file_format": "mp4",
"file_id": "9df00eca-3221-49c6-8a64-07850c9a5921",
"file_type": "video",
"frame_rate": 24,
"height": 180,
"is_varying_frame_rate": false,
"size_mbytes": 29.620187759399414,
"storage_url": "https://storage.rendi.dev/temp_files/224ea098-5c10-419b-8a77-707d89443c56/42c95292-d953-4b5a-8a58-cf1513363a33/output_180p.mp4",
"width": 320
}
},
"status": "SUCCESS",
"total_processing_seconds": 24.955581
}
Authorizations
Path Parameters
The UUID of the FFmpeg command to check status for
Response
200
application/json
Successful Response
Response model for FFmpeg command status.
Contains information about the command execution status, any errors that occurred, output files generated, and the original request details.
curl --request GET \
--url https://api.rendi.dev/v1/commands/{command_id} \
--header 'X-API-KEY: <api-key>'
{
"command_id": "123e4567-e89b-12d3-a456-426614174000",
"ffmpeg_command_run_seconds": 19.58051347732544,
"original_request": {
"ffmpeg_command": "-i {{in_1}} -ss 00:00 -to 00:30 -filter_complex [0:v]split=2[vid1][vid2];[vid1]scale=trunc(oh*a/2)*2:320:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:320:-1:-1[320p];[vid2]scale=trunc(oh*a/2)*2:180:force_original_aspect_ratio=decrease,pad=trunc(oh*a/2)*2:180:-1:-1[180p] -map [320p] -map 0:a -c:a copy -c:v libx264 -preset medium {{out_1}} -map [180p] -map 0:a -c:a copy -c:v libx264 -preset medium {{out_2}}",
"input_files": {
"in_1": "https://storage.rendi.dev/sample/sample.avi"
},
"max_command_run_seconds": 300,
"output_files": {
"out_1": "output_320p.mp4",
"out_2": "output_180p.mp4"
}
},
"output_files": {
"out_1": {
"bitrate_audio_kb": 242.349609375,
"bitrate_video_kb": 370.5654296875,
"codec": "h264",
"duration": 30,
"file_format": "mp4",
"file_id": "f775b15d-67e9-4235-b89f-4bb33c0a5f57",
"file_type": "video",
"frame_rate": 24,
"height": 320,
"is_varying_frame_rate": false,
"size_mbytes": 2.2677812576293945,
"storage_url": "https://storage.rendi.dev/temp_files/224ea098-5c10-419b-8a77-707d89443c56/42c95292-d953-4b5a-8a58-cf1513363a33/output_320p.mp4",
"width": 568
},
"out_2": {
"bitrate_audio_kb": 239.9833984375,
"bitrate_video_kb": 160.955078125,
"codec": "h264",
"duration": 596.459,
"file_format": "mp4",
"file_id": "9df00eca-3221-49c6-8a64-07850c9a5921",
"file_type": "video",
"frame_rate": 24,
"height": 180,
"is_varying_frame_rate": false,
"size_mbytes": 29.620187759399414,
"storage_url": "https://storage.rendi.dev/temp_files/224ea098-5c10-419b-8a77-707d89443c56/42c95292-d953-4b5a-8a58-cf1513363a33/output_180p.mp4",
"width": 320
}
},
"status": "SUCCESS",
"total_processing_seconds": 24.955581
}