Pureframe AI API Documentation

Pureframe AI processes videos asynchronously. An upload returns a job_id that you can poll while the video is prepared for search.

Accepted formats

Maximum file size is 5 GB per upload.

collection_id is required: a video must belong to a collection. See Collections to create one first.

curl -X POST https://api.pureframe.ai/v1/upload \
  -H "Authorization: Bearer pf_..." \
  -F "collection_id=col_abc123" \
  -F "file=@footage.mp4"

{
  "data": {
    "job_id": "job_xyz789",
    "video_id": "vid_def456",
    "status": "queued"
  }
}

Save both job_id (for tracking progress) and video_id (for searching and managing the video later). See Processing Status for polling details.

See Processing lifecycle for status tracking and failure guidance.