API Reference
Videos
Create video

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.