# VoxCut: Headless AI Video Clipping API

VoxCut is a production-ready, API-first engine for automated short-form video clipping. It is designed for developers building video automation and company owners scaling content operations.

## Core Value Proposition
- **For Developers:** Clean REST API, async jobs, webhook-first delivery, and structured JSON metadata.
- **For Company Owners:** Higher team throughput, lower manual editing costs, and scalable output across multiple channels.

## Key Capabilities
- **Speaker Tracking:** Automatically detects and tracks active speakers with sub-frame precision for multi-speaker layouts.
- **Semantic Extraction:** AI-driven selection of high-signal moments based on narrative density and engagement metadata.
- **Programmatic Branding:** Inject custom caption styles, progress bars, and overlays via JSON configuration.
- **Webhook Delivery:** Receive structured payloads with direct CDN links and metadata upon job completion.

## Integration Flow
1. **Ingest:** Push MP4/MOV URLs or cloud storage paths via `POST /v1/ingest`.
2. **Process:** VoxCut extracts speakers, generates captions, and crops to 9:16 automatically.
3. **Deliver:** Receive a signed callback with clip URLs, crop coordinates, and semantic tags.

## Data Schema (v0.2)
- `clip_url`: Direct signed URL to the processed 9:16 MP4.
- `bounding_box`: Dynamic crop coordinates for vertical output.
- `caption_track`: SRT/VTT formatted captions with precise timestamps.
- `speaker_confidence`: float [0-1] for active speaker identification.
- `highlight_score`: predicted engagement score [0-1].
- `topic_tags`: Semantic tags for campaign taxonomy.

## Use Cases
- **Company Owners & Operators:** repeatable production systems with better resource utilization.
- **Developers & Product Teams:** Embedding video clipping into SaaS, internal tooling, or automation stacks.
- **Media Brands:** Converting large media libraries into publish-ready social clips in bulk.

## Access
VoxCut is currently in private beta. Request early API access at [https://voxcut.dev/#api-access](https://voxcut.dev/#api-access).