openclip-clipping

Submit the video URL with submit_video, poll get_video_status until the status is completed, then call list_clips to get ranked viral moments. Each moment includes a title, hook, social copy, timestamps in milliseconds, and a permanent CDN clip URL.

Submit the podcast or stream URL to OpenClip and rank the returned moments by virality_score, which runs from 0 to 10. The viral_score_details field breaks down hook strength, shareability, rewatchability, surprise, and emotional impact to explain each ranking.

Yes, the clipping pipeline is paid and requires an active OpenClip subscription plus credits, where credits represent minutes of processing. Submit always succeeds when authenticated; a missing subscription surfaces later as a failed status, and depleted credits surface as pending_credits.

A job that fails almost immediately after submit usually means there is no active subscription on the account. Check the status from get_video_status: failed indicates a subscription issue, pending_credits means the team is out of credits, and download_failed means the source URL could not be fetched.

Yes, call create_upload with the filename and content type, PUT the file bytes to the upload target, then call complete_upload to start the paid clipping pipeline. After that, poll get_video_status and list clips exactly as with a URL submission.

The API does not support projects or folders, and processing is fully asynchronous so every step requires polling rather than assuming completion. The progress field is coarse and unreliable for control flow; always branch on the status value instead.