Skip to main content
Pureframe AI processes each uploaded video asynchronously. The upload response includes a job_id that you can use to track progress.

What processing prepares

During processing, Pureframe AI prepares searchable information from:
  • Visual content
  • Spoken audio
  • Scene context, when available on your plan
  • Text visible on screen
Scene labels and captions are available on Pay as you go and Enterprise plans.

Track progress

Poll GET /v1/jobs/{job_id} until the job reaches done or failed. A video becomes searchable only after its job reaches done. Use exponential backoff when polling. You can also subscribe to job.completed and job.failed webhooks. See Processing status.

Processing time

Processing time depends on video length, format, content, and current demand. Track the job rather than relying on a fixed completion estimate.

Handle a failed job

If a job reaches failed, re-upload the video to create a new job. If the same file fails again, verify that its container and codec are supported before contacting support. See Upload videos for supported formats and Errors for API error details.