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"
    },
    "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

​
X-API-KEY
string
header
required

API key required for authentication. Must be provided in the X-API-KEY header.

Path Parameters

​
command_id
string
required

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.

​
command_id
string
required

Unique identifier for the submitted command

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
enum<string>
required

Current status of the FFmpeg command

Available options:
QUEUED,
PROCESSING,
FAILED,
SUCCESS
​
original_request
object
required

The original request that was sent to the server

Example:
{
  "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"
  },
  "output_files": {
    "out_1": "output_320p.mp4",
    "out_2": "output_180p.mp4"
  }
}
​
error_status
string | null

Status of any error that occurred during command execution

Example:

"UNREACHABLE_INPUT_FILE"

​
error_message
string | null

Error details if the command failed

Example:

"Input file url https://rendi.dev/example does not have a valid file name in its' end."

​
output_files
object | null

Dictionary mapping file aliases to their output file storage

Example:
{
  "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
  }
}
​
ffmpeg_command_run_seconds
number | null

The exact time the specific FFMPEG command took on our servers, in seconds

​
total_processing_seconds
number | null

Processing time, in seconds, since recieving the command, this includes network times, parsing times, and FFMPEG command execution time