Find Moments API

Find Moments API

Find Moments API memungkinkan Anda mendeskripsikan momen yang Anda inginkan menggunakan bahasa alami — seperti "reaksi lucu" atau "demo produk" — dan API akan menemukan serta mengekstrak klip yang sesuai dengan stempel waktu, judul, deskripsi, dan tagar dari video dengan panjang berapa pun, termasuk konten berdurasi berjam-jam. Jika ekspor diaktifkan, respons juga menyertakan tautan unduhan video yang telah dirender untuk setiap klip, dengan opsi auto-reframe yang menjaga subjek utama tetap di tengah dan overlay Animated Caption untuk output yang lebih menarik.

Sumber Video yang Didukung

API menerima URL dari platform berikut: YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble, dan lainnya.

Anda juga dapat menggunakan file yang diunggah secara lokal. Unggah lokal memerlukan paket Standard atau lebih tinggi. Lihat Upload API untuk detailnya.

Kirim Tugas Find Moments

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

Body Permintaan

Saat merender klip, Anda dapat mengaktifkan fitur seperti Animated Caption, AI Reframe, dan overlay teks AI Hook opsional. Dengan AI Reframe, sistem mendeteksi subjek utama dalam frame, menjaga subjek tersebut tetap di tengah, mengoptimalkan crop untuk rasio aspek yang dipilih, dan memilih layout paling sesuai berdasarkan struktur scene. Fitur-fitur ini dikontrol oleh parameter yang namanya diawali dengan enable_ (lihat tabel di bawah).

Nilai layout Reframe

Nilai reframe_layout yang diizinkan tergantung pada ratio. Auto selalu diizinkan (default); menghilangkan field ini atau memberikan string kosong memiliki perilaku yang sama. Berikan nama layout persis seperti di bawah (peka huruf besar/kecil dan spasi).

Perilaku enable_export

• Jika enable_export kosong atau false, API hanya mengembalikan rentang waktu klip, judul, deskripsi, dan metadata terkait. Tidak ada rendering yang dilakukan, dan tidak ada tautan ekspor dalam hasil. Parameter ratio, reframe_layout, resolution, caption_display, enable_caption, cc_style_tpl, enable_ai_hook, ai_hook_script_style, ai_hook_position, dan enable_ai_reframe tidak berpengaruh saat pembuatan tugas. Anda dapat merender klip yang dipilih nanti dengan endpoint Ekspor Klip yang Ada.
• Jika enable_export adalah true, parameter tersebut berlaku, setiap klip dirender segera, dan hasil menyertakan tautan unduhan untuk setiap klip. Karena setiap klip dirender, pemrosesan mungkin membutuhkan waktu lebih lama.

Body permintaan mengatur enable_export ke true. Klip dirender; setiap klip menyertakan export_link.

Permintaan

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"
  }'

Respons pengiriman

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

Body permintaan menghilangkan enable_export atau mengaturnya ke false. Hanya rentang waktu klip, judul, deskripsi, dan tagar yang dikembalikan; tidak ada rendering, tidak ada tautan ekspor.

Permintaan

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"
  }'

Respons pengiriman

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

Ambil Hasil Find Moments

Lakukan polling untuk hasil hingga status menjadi SUCCEEDED.

Hasil bertahap: Saat status adalah ONGOING, setiap panggilan mengembalikan klip yang sudah dihasilkan sejauh ini — Anda dapat mulai memproses hasil parsial segera. Saat status berubah menjadi SUCCEEDED, respons berisi seluruh kumpulan klip.

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

Parameter Path

Contoh Permintaan

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"

Saat tugas dikirim dengan enable_export: true, setiap klip menyertakan export_link untuk video yang telah dirender:

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

Saat tugas dikirim tanpa enable_export (atau dengan enable_export: false), klip tidak menyertakan 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
      }
    ]
  }
}

Field Respons

Objek Klip

Ekspor Ulang Klip yang Ada

Jika Anda ingin merender klip nanti atau mengekspornya ulang dengan gaya subtitel berbeda, rasio aspek, AI hook, overlay, atau pengaturan ekspor lainnya, gunakan Clips Export API.

Untuk proyek Find Moments, berikan id tugas yang dikembalikan oleh POST /api/v2/clips/find-moments sebagai project_id dalam permintaan ekspor.