Skip to main content

Large File Upload (TUS Protocol)

Scriptix uses the TUS protocol for resumable file uploads. Files larger than 2GB use TUS exclusively.

TUS Upload Configuration​

Endpoint: POST ${API_BASE_URL}/api/v3/files/

Authentication: Bearer token required in headers

Implementation Details:

  • Chunk Size: 50MB (52,428,800 bytes)
  • Retry Delays: [0, 3000, 5000, 10000, 20000, 30000, 60000] milliseconds
  • Fingerprint Format: tus-{filename}-{mimetype}-{filesize}-{uuid}
  • Fingerprint Storage: Enabled (storeFingerprintForResuming: true)
  • Fingerprint Removal: Disabled on success (removeFingerprintOnSuccess: false)
  • Credentials: Sent with requests (withCredentials: true)

File Size Limits​

  • Per File: 40GB maximum
  • Total Upload: Configured via VITE_MAX_FILE_SIZE environment variable (default: 42,949,672,960 bytes / ~40GB)
  • Direct Upload Threshold: Files under 2GB may use direct Azure upload instead of TUS

Supported File Formats​

Video Files: .mp4, .mov, .avi, .mkv, .webm, .m4v, .3gp, .flv, .wmv, .ts

Audio Files: .mp3, .wav, .m4a, .aac, .ogg, .flac, .wma, .aiff

Subtitle Files (caption type): .srt, .vtt, .sbv, .ttml, .html

Document Files (document type): .txt, .docx, .pdf, .doc, .html

Upload Response​

After TUS upload completion, the file ID is used in subsequent API calls to create transcription sessions or documents.

TUS Protocol: Official TUS Specification