Uploading Videos
Uploading videos is done by sending a PUT
request to the /videos/upload
endpoint to create a new video object.
You will get a response containing a signed S3URL to upload the video file to.
Create video object
curl -X PUT https://app.ignitevideo.cloud/api/videos/upload \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Your video title", "visibility": "private" | "public"}'
If you have a video with spoken text content and want to start the AI auto transcription to start right after the video encoding, you can do so by setting two additional parameters when doing the PUT request to create the new video:
{
...,
"language": string, // "de-DE" | "..." locale of the spoken language
"autoTranscribe": true
}
Response
{
"videoId": "[VIDEO_ID]",
"title": "Your video title",
"signedUrl": "[SIGNED_URL]",
}
Upload video file
Upload your video file as a PUT
request to the signed URL returned in the previous step.
You have to pass the mime type of the file as Content-Type
header. You can get the mime type from your local video file via the file input element.
curl -X PUT [SIGNED_URL] \
-H "Content-Type: [MIME_TYPE]" \
--data-binary "@[PATH_TO_VIDEO_FILE]"
Encoding process
After the video file has been uploaded, the video will be encoded. This process can take a while, depending on the video size and encoding complexity.
You can check the encoding status of a video by calling the /videos/[VIDEO_ID]
endpoint as described in the get video section.