Introduction
About the API
Command Structure
We use a simple JSON format to send commands.
vCPUs
You control how many vCPUs each command uses, up to your account’s maximum. Multiple commands can run in parallel as long as their total vCPU usage doesn’t exceed your quota.
File naming
When sending commands you will notice that you will need to use {{alias}}
for file placeholders for input and output files.
Input files will need to be sent in the input_files
dictionary, with each key starting with in_
prefix, and the value should be an online accessible storage endpoint for Rendi to pull files from.
The in_
prefix is mandatory for Rendi to consider this as a valid input fille.
Output files will similarly be in ‘output_files’ dictionary, with each key starting with ‘out_’ prefix, and the value is the required output file name, without any folder or path structure. Output files will be places in a Rendi hosted storage and their name will be as you specified.
The out_
prefix is mandatory for Rendi to consider this as a valid input fille.
Only alpha-numeric characters and underscores are allowed for output file names, for the file extension a period character is also allowed (e.g. output_1.mp4
).
{{in_1}}
with backslashes and brackets \{\{in_1\}\}
.Reasons for aliasing files instead of providing them directly within the command
-
The command itself and its files are separate entities. For example - you can use the same input files for several commands, or reuse the same command with different inputs and outputs.
-
We validate file names and their locations.
-
In the future we will allow you to integrate Rendi with your own private storage repositories, and Rendi will need to pull and put files using specific integrations.
Output file storage
Output files are stored indefinitely until you choose to delete them using our deletion endpoints.
Authentication
All API endpoints are authenticated using an API Key which you get when you activate your account. The API Key needs to be provided as the value of HTTP Header X-API-KEY
as