Skip to main content

​
Overview

CommandDescriptionCost
naive video clip <youtube_url>Extract short-form clips from a YouTube video4 credits
naive video clip-status <job_id>Check clip extraction or editing statusFree
naive video clip-edit <video_url>Add captions, zooms, and B-roll to a video3 credits
Completed clipping and editing jobs are auto-ingested to the Media Asset Manager. Use naive media list --source video_clipping to find them.

​
Extract Clips

Submits a YouTube video for AI clip extraction. Clips are ranked by virality score. Processing takes 5-10 minutes. 
naive video clip "https://youtube.com/watch?v=abc123" --title "Podcast Highlights"
naive video clip "https://youtu.be/abc123" --title "Best Moments" --min-length 30 --max-length 90 --wait

​
Options

FlagRequiredDescription
youtube_urlYesYouTube video URL (positional argument)
--title <title>YesProject title
--language <lang>NoVideo language code (default: en)
--template <name>NoCaption template name
--min-length <seconds>NoMinimum clip length (15-300, default: 15)
--max-length <seconds>NoMaximum clip length (15-300, default: 60)
--waitNoBlock until extraction completes

​
Output (submitted)

{
  "success": true,
  "action": "video.clip.submitted",
  "result": { "job_id": "job-uuid-123", "status": "queued" },
  "next_steps": [
    { "command": "naive video clip-status job-uuid-123", "description": "Check clipping progress" },
    { "command": "naive jobs get job-uuid-123", "description": "Get full job details" }
  ],
  "hints": [
    "Clip extraction submitted — typically takes 5-10 minutes",
    "Credits deducted only on successful completion (4 credits)",
    "When complete, clips are ranked by AI virality score (0-100)"
  ]
}

​
Output (completed — with --wait)

{
  "success": true,
  "action": "video.clip.completed",
  "result": {
    "id": "job-uuid-123",
    "status": "completed",
    "result": {
      "clips": [
        {
          "id": "clip-1",
          "title": "The Secret to Scaling",
          "duration": 42,
          "virality_score": { "total": 87, "shareability": 82, "hook_strength": 91, "story_quality": 85, "emotional_impact": 90 },
          "direct_url": "https://..."
        }
      ],
      "clip_count": 5,
      "top_virality_score": 87
    },
    "credits_used": 4
  },
  "next_steps": [
    { "command": "naive social post \"The Secret to Scaling\" --platforms youtube --youtube-type SHORT --media-url \"https://...\" --publish", "description": "Post top clip as YouTube Short" }
  ],
  "hints": ["5 clips ready (top score: 87)", "Tip: Use 'naive social post' to publish top clips to YouTube, TikTok, Instagram"]
}

​
Check Status

naive video clip-status <job_id>
Works for both clip extraction and video editing jobs. 
{
  "success": true,
  "action": "video.clip-status",
  "result": {
    "id": "job-uuid-123",
    "status": "queued",
    "type": "video_clipping"
  },
  "next_steps": [
    { "command": "naive video clip-status job-uuid-123", "description": "Check again in 30-60 seconds" }
  ],
  "hints": ["Job status: queued", "Clip extraction typically takes 5-10 minutes"]
}

​
Edit Video

Submits a video for AI-powered editing with captions, zooms, and B-roll. Processing takes 5-10 minutes. 
naive video clip-edit "https://example.com/video.mp4" --title "Enhanced Clip"
naive video clip-edit "https://example.com/video.mp4" --title "Full Edit" --magic-zooms --magic-brolls --brolls-percentage 30 --wait

​
Options

FlagRequiredDescription
video_urlYesPublic video URL (positional argument)
--title <title>YesProject title
--language <lang>NoVideo language code (default: en)
--template <name>NoCaption template name
--magic-zoomsNoEnable AI-powered zooms
--magic-brollsNoEnable AI-generated B-roll
--brolls-percentage <n>NoB-roll percentage (0-100)
--waitNoBlock until editing completes

​
Output (submitted)

{
  "success": true,
  "action": "video.clip-edit.submitted",
  "result": { "job_id": "job-uuid-456", "status": "queued" },
  "next_steps": [
    { "command": "naive video clip-status job-uuid-456", "description": "Check editing progress" }
  ],
  "hints": [
    "Video edit submitted — typically takes 5-10 minutes",
    "Credits deducted only on successful completion (3 credits)"
  ]
}

​
Output (completed — with --wait)

{
  "success": true,
  "action": "video.clip-edit.completed",
  "result": {
    "id": "job-uuid-456",
    "status": "completed",
    "result": {
      "video_url": "https://...",
      "download_url": "https://..."
    },
    "credits_used": 3
  },
  "next_steps": [
    { "command": "# Download: curl -o edited.mp4 \"https://...\"", "description": "Download edited video" }
  ],
  "hints": ["Video editing complete — download URL available"]
}

​
Credit Behavior

  • Credits are NOT reserved at submission time
  • Credits are deducted ONLY when the job completes successfully
  • Failed or cancelled jobs cost nothing
  • Clip extraction: 4 credits | Video editing: 3 credits
  • Use naive usage to audit credit deductions