examples

OmniTranscripts Examples

Real-world usage examples for OmniTranscripts.

Directory Structure

Directory	Description
local-files/	Transcribing local audio/video files
short-form/	YouTube Shorts, TikTok, Instagram Reels
docker/	Docker-based workflows
production/	Async jobs, webhooks, polling patterns

Prerequisites

All examples assume:

• OmniTranscripts is running on http://localhost:3000
• You have a valid API_KEY set

Set your API key:

export API_KEY="your-api-key-here"

Quick Reference

Local File Upload

curl -X POST http://localhost:3000/transcribe \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@./video.mp4"

URL Transcription

curl -X POST http://localhost:3000/transcribe \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/audio.mp3"}'

Check Job Status

curl -X GET "http://localhost:3000/transcribe/$JOB_ID" \
  -H "Authorization: Bearer $API_KEY"