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

urlstringOptional

The presigned URL to which the file should be uploaded

fileKeystringOptional

The S3 key for the uploaded file

videoUrlstringOptional

The URL to use in the 'video' field of detect-video or preprocess-video endpoints

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"
}