Skip to main content
​
youtube_url
string
required
YouTube video URL to extract clips from
​
title
string
required
Project title
​
language
string
Video language code (default: "en")
​
template
string
Caption template name (default: "Hormozi 2")
​
min_clip_length
number
Minimum clip length in seconds (default: 15)
​
max_clip_length
number
Maximum clip length in seconds (default: 60)
curl -X POST https://api.usenaive.ai/v1/video/clips \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "youtube_url": "https://youtube.com/watch?v=abc123",
    "title": "Podcast Highlights",
    "language": "en",
    "min_clip_length": 15,
    "max_clip_length": 60
  }'

{
  "job_id": "job-uuid",
  "status": "queued",
  "type": "video_clipping",
  "estimated_seconds": 600,
  "estimated_credits": 4,
  "hint": "Poll GET /v1/video/clips/job-uuid or GET /v1/jobs/job-uuid. Clipping typically takes 5-10 minutes. Credits charged on completion only."
}
Cost: 4 credits per clipping job. Charged on completion only.

​
Completed Result

When polling via GET /v1/jobs/:id or GET /v1/video/clips/:jobId: 
{
  "id": "job-uuid",
  "type": "video_clipping",
  "status": "completed",
  "result": {
    "clips": [
      {
        "id": "clip-uuid-1",
        "title": "The Secret to Scaling",
        "duration": 42,
        "virality_score": {
          "total": 87,
          "shareability": 82,
          "hook_strength": 91,
          "story_quality": 85,
          "emotional_impact": 90
        },
        "download_url": "https://...",
        "direct_url": "https://...",
        "preview_url": "https://..."
      }
    ],
    "clip_count": 5,
    "top_virality_score": 87
  },
  "credits_used": 4,
  "created_at": "2026-05-19T10:30:00Z",
  "completed_at": "2026-05-19T10:37:02Z"
}