Introduction

https://api.usenarrative.ai

┌──────────────────┐     ┌──────────────────┐     ┌──────────────────┐
│  POST /endpoint  │ ──▶ │  Poll GET /{id}  │ ──▶ │  Get Result      │
│  Returns task_id │     │  Check status    │     │  When complete   │
└──────────────────┘     └──────────────────┘     └──────────────────┘

# 1. Start highlight generation (async)
curl -X POST https://api.usenarrative.ai/api/v1/sports/highlights \
  -F "video=@football_game.mp4" \
  -F "duration=600" \
  -F "editorial_instructions=Focus on touchdowns and big plays"
# Returns: { "task_id": "task_abc123", "status": "pending" }

# 2. Poll for completion
curl https://api.usenarrative.ai/api/v1/sports/highlights/task_abc123
# Returns: { "status": "processing", "progress": 45 }
# ... wait and poll again ...
# Returns: { "status": "completed", "result": { "video_url": "..." } }