Find Moments API

Find Moments API

The Find Moments API lets you describe the moments you want using natural language — such as "funny reactions" or "product demos" — and the API finds and extracts matching clips with timestamps, titles, descriptions, and hashtags from videos of all lengths, including hours-long content. If export is enabled, the response also includes rendered video download links for each clip, with optional auto-reframe that keeps the main subject centered and Animated Caption overlays for more engaging outputs.

Supported Video Sources

The API accepts URLs from the following platforms: YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble and more.

You can also use locally uploaded files. Local upload requires a Standard plan or above. See the Upload API for details.

Submit Find Moments Task

POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments

Request Body

When rendering clips, you can enable features such as Animated Caption, AI Reframe, and optional AI Hook text overlays. With AI Reframe, the system detects the main subject in the frame, keeps that subject centered, optimizes the crop for the chosen aspect ratio, and selects the most suitable layout based on the structure of the scene. These features are controlled by parameters whose names start with enable_ (see the table below).

Reframe layout values

Allowed reframe_layout values depend on ratio. Auto is always allowed (default); omitting the field or passing an empty string behaves the same. Pass layout names exactly as below (case- and spacing-sensitive).

enable_export behavior

• When enable_export is empty or false, the API only returns clip time ranges, titles, descriptions, and related metadata. No rendering is performed, and there are no export links in the result. The parameters ratio, reframe_layout, resolution, caption_display, enable_caption, cc_style_tpl, enable_ai_hook, ai_hook_script_style, ai_hook_position, and enable_ai_reframe have no effect at task creation time. You can later render selected clips with the Export Existing Clips endpoint.
• When enable_export is true, those parameters take effect, each clip is rendered immediately, and the result includes a download link for each clip. Because each clip is rendered, processing may take longer.

Request body sets enable_export to true. Clips are rendered; each clip includes an export_link.

Request

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "query": "sample query",
    "project_name": "sample project name",
    "enable_export": true,
    "resolution": "FHD_1080",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Submit response

{
  "data": {
    "id": "proj_moment_789",
    "name": "sample project name",
    "status": "CREATED"
  }
}

Request body omits enable_export or sets it to false. Only clip time ranges, titles, descriptions, and tags are returned; no rendering, no export links.

Request

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "query": "sample query",
    "project_name": "sample project name"
  }'

Submit response

{
  "data": {
    "id": "proj_moment_456",
    "name": "sample project name",
    "status": "CREATED"
  }
}

Get Find Moments Results

Poll for results until status is SUCCEEDED.

Incremental results: When status is ONGOING, each call returns the clips generated so far — you can start processing partial results immediately. When status changes to SUCCEEDED, the response contains the complete set of clips.

GET https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments/results/{id}

Path Parameters

Example Request

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments/results/proj_moment_456 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

When the task was submitted with enable_export: true, each clip includes an export_link for the rendered video:

{
  "data": {
    "id": "proj_moment_789",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1775831883112,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 120000,
        "end_ms": 185000,
        "thumbnail": "https://cdn.example.com/thumb/moment_001.jpg",
        "tags": ["product", "announcement"],
        "desc": "sample description",
        "score": 81,
        "export_link": "https://cdn.example.com/export/moment_001.mp4"
      }
    ]
  }
}

When the task was submitted without enable_export (or with enable_export: false), clips do not include export_link:

{
  "data": {
    "id": "proj_moment_456",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "expire_at": 1775831883112,
    "cost_usage": 120.0,
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": 120000,
        "end_ms": 185000,
        "thumbnail": "https://cdn.example.com/thumb/moment_001.jpg",
        "tags": ["product", "announcement"],
        "desc": "sample description",
        "score": 81
      }
    ]
  }
}

Response Fields

Clip Object

Re-export Existing Clips

If you want to render clips later or re-export them with a different subtitle style, aspect ratio, AI hook, overlays, or other export settings, use the Clips Export API.

For Find Moments projects, pass the task id returned by POST /api/v2/clips/find-moments as project_id in the export request.