Enhance the uploaded video. To upload the video, use the upload videos endpoint. After the video is uploaded, use this endpoint to start the video enhancing job. Make sure to set the input_video
attribute to the uploaded video’s ID which is returned in the response of the upload videos endpoint.
AI filters are called ml-models
in the API docs as they are actually machine learning
models.
See the /api/ml-models
to learn more about ML models selection. After choosing the appropriate models, pass the list of their IDs in the ml_models
parameter. You should pass at least one AI filter.
Free Previews will process a short segment of the video (10sec) and won’t cost any 🪙 Credits. To enable Free Previews in a job, set the preview = True
.
You can use the start_frame
to set the starting frame of the Free Preview segment.
end_frame
parameter is ignored if preview = True
.
To process a whole video, don’t specify start_frame
and end_frame
and set
preview = False
.
To process a specific video segment, set the start_frame
to the starting frame of the
segment, and end_frame
to the end frame of the segment. end_frame
must
be > start_frame
.
stabilization_smoothing
parameter is ignored unless the AI Stabilization Filter is set as
one of the ML models.
sharpen_strength
parameter is ignored unless the AI Sharpen Filter is set as
one of the ML models.
⚠️ IMPORTANT: Your account will be limited by the total storage of all enhanced and uploaded videos. While this limit will be set to a high number (1TB+), we highly recommend you delete the enhanced video after the enhanced video is copied to your server. This ensures you won’t run into storage limit errors in the future.
Token-based authentication with required prefix "Token"
The response is of type object
.