Create video

Use this method to create a new video entity.

**Methods of creating** To upload the original video file to the server, there are several possible scenarios:

• **Copy from another server** – If your video is accessable via “http://”, “https://”, or “sftp://” public link, then you can use this method to copy a file from an external server. Set origin_url parameter with the link to the original video file (i.e. “https://domain.com/video.mp4”). After method execution file will be uploaded and will be sent to transcoding automatically, you don’t have to do anything else. Use extra field origin_http_headers if authorization is required on the external server.
• **Direct upload from a local device** – If you need to upload video directly from your local device or from a mobile app, then use this method. Keep origin_url empty and use TUS protocol (tus.io) to upload file. More details are here “Get TUS’ upload” After getting the video, it is processed through the queue. There are 2 priority criteria: global and local. Global is determined automatically by the system as converters are ready to get next video, so your videos rarely queue longer than usual (when you don’t have a dedicated region). Local priority works at the level of your account and you have full control over it, look at “priority” attribute.

**AI processing** When uploading a video, it is possible to automatically create subtitles based on AI. Read more:

• What is “AI Transcribe”.
• If the option is enabled via auto_transcribe_audio_language: auto|, then immediately after successful transcoding, an AI task will be automatically created for transcription.
• If you need to translate subtitles from original language to any other, then AI-task of subtitles translation can be applied. Use auto_translate_subtitles_language: default| parameter for that. Also you can point several languages to translate to, then a separate subtitle will be generated for each specified language.
• How to “add AI-generated subtitles to an exist video”. The created AI-task(s) will be automatically executed, and result will also be automatically attached to this video as subtitle(s). Please note that transcription is done automatically for all videos uploaded to our video hosting. If necessary, you can disable automatic creation of subtitles. If AI is disabled in your account, no AI functionality is called.

**Advanced Features** For details on the requirements for incoming original files, and output video parameters after transcoding, refer to the Knowledge Base documentation. By default video will be transcoded according to the original resolution, and a quality ladder suitable for your original video will be applied. There is no automatic upscaling; the maximum quality is taken from the original video. If you want to upload specific files not explicitly listed in requirements or wish to modify the standard quality ladder (i.e. decrease quality or add new non-standard qualities), then such customization is possible. Please reach out to us for assistance.

Additionally, check the Knowledge Base for any supplementary information you may need.