README.md

---
title: ClipBot FFmpeg Service
emoji: 🎬
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
---

# ClipBot FFmpeg Service

Split-screen video processor for ClipBot pipeline.

## API Endpoints

- `POST /clip` — start split-screen job
- `GET /job/<id>` — poll job status  
- `GET /download/<filename>` — download output file
- `POST /upload_gameplay` — upload gameplay clips
- `GET /health` — health check

## Usage from VPS clipbot_api.py

```python
HF_CLIP_URL = "https://YOUR-SPACE.hf.space"

# Send to HuggingFace for processing
response = requests.post(f"{HF_CLIP_URL}/clip", json={
    "videoId": video_id,
    "mainVideoUrl": f"http://YOUR_VPS_IP:5000/serve/{video_id}",
    "gameplayUrl": "https://YOUR-SPACE.hf.space/gameplay/1.mp4",
    "duration": 58
})
```