Get Video Upload URL

Generate presigned S3 URLs for large video file uploads

Get presigned URL for uploading large video files

post

https://api.bitmind.ai/oracle/v1https://staging-api.bitmind.ai/oracle/v1http://localhost:3000/prod/oracle/v1http://localhost:3000/staging/oracle/v1

/34/get-video-upload-url

Returns a presigned S3 URL that can be used to upload a video file directly to S3, bypassing API payload limits (useful for files larger than 6MB). After uploading to S3, the returned videoUrl can be used with the detect-video or preprocess-video endpoints. The presigned URL expires in 15 minutes and has a 200MB upload limit.

Authorizations

BearerAuthJwtAuth

AuthorizationstringRequired

API key authentication for service-to-service communication.

Include your API key in the Authorization header:

Authorization: Bearer your-api-key
x-bitmind-application: oracle-api

Body

application/json

filenamestringRequired

The name of the file to upload (used to determine content type). Supported formats: mp4 (video/mp4), mov (video/quicktime), avi (video/x-msvideo), webm (video/webm). If extension is not recognized, defaults to video/mp4.

contentTypestringOptional

(Optional) The content type of the file, if known. If not provided, it will be inferred from the filename extension. Common types: video/mp4, video/quicktime, video/x-msvideo, video/webm.

Responses

200

Successful response

application/json

400

Bad request - Invalid input data

application/json

401

Unauthorized - Invalid or missing authentication

application/json

429

Rate limit exceeded

application/json

post

/34/get-video-upload-url

HTTPcURLJavaScriptPython

POST /oracle/v1/34/get-video-upload-url HTTP/1.1
Host: api.bitmind.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "filename": "example_video.mp4"
}

MP4 FileWith Content Type

{
  "url": "https://applications-temp-videos.s3.amazonaws.com/",
  "fields": {
    "key": "upload/1640995200000-uuid-example_video.mp4",
    "policy": "eyJleHBpcmF0aW9uIjoi...",
    "signature": "abc123..."
  },
  "fileKey": "upload/1640995200000-uuid-example_video.mp4",
  "videoUrl": "https://applications-temp-videos.s3.amazonaws.com/upload/1640995200000-uuid-example_video.mp4"
}