WayinVideo - Find Moments in the Video

---

name: find-moments description: Find specific moments in a video using a natural language query. Ideal for locating particular scenes, topics, or events in long videos (e.g., “the part where they talk about taxes”). Use this when the user has a clear search intent; not recommended for broader requests like "highlights" or "best moments." Export clips with customizable aspect ratios, caption styles, and AI reframing. Supports both online URLs and local files. user-invocable: true metadata: clawdbot: emoji: "🎥" requires: bins: ["python3"] env: ["WAYIN_API_KEY"] primaryEnv: "WAYIN_API_KEY" files: ["scripts/*"]

---

AI Find Video Moments

This skill searches and locates specific content within a video using natural language queries based on the WayinVideo API.

Execution Workflow

Step 0: Check API Key

Check if the WAYIN_API_KEY is available in the environment or user context. If it is missing, ask the user to provide it or create one at https://wayin.ai/wayinvideo/api-dashboard.

Step 1: Identify Video Source

Determine if the input is a web URL (e.g., YouTube link) or a local file path.

> [!IMPORTANT] > The WayinVideo API supports the following platforms for direct URL processing: YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Instagram, Zoom, Rumble, Google Drive. If the platform is NOT supported, you must treat it as a local file (download it first if possible, then upload).

Step 2: Upload (Local Files or Unsupported URLs Only)

If the input is a local file or from an unsupported platform, you MUST upload it first to get an identity token: python3 /scripts/upload_video.py --file-path *(If the input is a web URL from a supported platform, skip this step.)*

Step 3: Search Moments

Submit the video and your query to find specific moments using the URL or the identity (from Step 2): python3 /scripts/submit_task.py --url "" --query "" [options]

> [!TIP] > For best results, keep the brief and self-contained. Use English whenever possible.

This script will output the Project ID and the path to an initial result JSON file in your workspace. Save both values for polling the results later.

#### Options:

--target : (Optional) Target language for output content. Auto-detected if omitted. If specified, you MUST read assets/supported_languages.md first to find the correct language code.

--name : (Optional) A custom name for this task.

--top-k : (Optional) The best K moments to return. Defaults to 10. Pass -1 to return all matching moments.

--export: (Optional) Enable rendering of clips (returns export links).

--ai-hook: (Optional) Enable automatically generated text hooks. (Used with --export)

--ai-hook-style