Find Moments

Find Moments

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. If export is enabled, the response also includes rendered video download links for each clip.

Supported Video Sources

The API accepts URLs from the following platforms: YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Instagram, Zoom, Rumble, Google Drive 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/open/v2/clips/find-moments

Request Body

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, resolution, caption_display, enable_caption, enable_ai_reframe, and cc_style_tpl have no effect.
• When enable_export is true, those parameters take effect, each clip is rendered, and the result includes a download link for each clip. Because each clip is rendered, processing may take longer.

Example 1: Without export (clip metadata only)

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/open/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

{
  "code": "0",
  "data": {
    "id": "proj_moment_456",
    "name": "sample project name",
    "status": "CREATED"
  },
  "message": "success"
}

Example 2: With export (rendered clips and download links)

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/open/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,
    "ratio": "RATIO_9_16",
    "resolution": "FHD_1080",
    "enable_caption": true,
    "enable_ai_reframe": true
  }'

Submit response

{
  "code": "0",
  "data": {
    "id": "proj_moment_789",
    "name": "sample project name",
    "status": "CREATED"
  },
  "message": "success"
}

Get Find Moments Results

Poll for results until status is SUCCEEDED.

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

Path Parameters

Example Request

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

Response example: without export

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

{
  "code": "0",
  "data": {
    "id": "proj_moment_456",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "api_units_usage": 120,
    "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"
      }
    ]
  },
  "message": "success"
}

Response example: with export

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

{
  "code": "0",
  "data": {
    "id": "proj_moment_789",
    "name": "sample project name",
    "status": "SUCCEEDED",
    "api_units_usage": 120,
    "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"
      }
    ]
  },
  "message": "success"
}

Clip Object