clips

naive video clip "https://example.com/podcast.mp4"
naive video clip "https://example.com/podcast.mp4" --aspect 16:9

{
  "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 — metered per finished clip + input minute",
    "When complete, clips are ranked by AI virality score (0-100)"
  ]
}

{
  "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": 13.2
  },
  "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"]
}

naive video clip-status <job_id>

{
  "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"]
}