Video Summarization API

Kirimkan video dengan panjang berapa pun dan terima ringkasan terstruktur, tagar, dan highlight timeline yang dihasilkan AI. API ini mendukung semua jenis konten mulai dari klip pendek hingga video berdurasi berjam-jam dari berbagai platform utama dan file yang diunggah secara lokal, beserta pengaturan bahasa.

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.

Alur Kerja

Kirim tugas ringkasan dari URL video
Polling hasil hingga status menjadi SUCCEEDED

Kirim Tugas Ringkasan

Kirimkan tugas ringkasan baru. Ini adalah titik masuk untuk semua fitur ringkasan.

POST https://wayinvideo-api.wayin.ai/api/v2/summaries

Body Permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
`video_url`	string	Ya	—	URL video sumber atau identifier file yang diunggah
`source_lang`	string	Tidak	`null`	Bahasa sumber video (lihat Bahasa yang Didukung). Jika `null`, sistem mendeteksi bahasa asli secara otomatis.
`target_lang`	string	Tidak	`null`	Bahasa target untuk konten output termasuk ringkasan, deskripsi, dan highlight (lihat Bahasa yang Didukung). Jika `null`, bahasa output mengikuti `source_lang`.

Contoh Permintaan

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -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",
    "target_lang": "en"
  }'

Respons

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

Field	Tipe	Deskripsi
`id`	string	Identifier tugas (digunakan dalam permintaan berikutnya)
`name`	string	Nama tugas
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`

Ambil Hasil Ringkasan

Ambil ringkasan, highlight, dan tagar. Lakukan polling hingga status menjadi SUCCEEDED.

GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/{id}

Parameter Path

Parameter	Tipe	Wajib	Deskripsi
`id`	string	Ya	ID tugas yang dikembalikan oleh endpoint pengiriman

Contoh Permintaan

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Respons

{
  "data": {
    "status": "SUCCEEDED",
    "title": "sample title",
    "video_thumbnail": "https://cdn.example.com/thumb/video_001.jpg",
    "summary": "sample summary text",
    "tags": ["#topic1", "#topic2", "#topic3"],
    "highlights": [
      {
        "start": 0,
        "end": 196000,
        "desc": "sample section title",
        "events": [
          {
            "timestamp": 160,
            "desc": "sample event description"
          },
          {
            "timestamp": 17920,
            "desc": "sample event description"
          }
        ]
      }
    ],
    "cost_usage": 54.0
  }
}

Field Respons Ringkasan

Field	Tipe	Deskripsi
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`
`error_message`	string	Alasan error (hanya ada saat `status` adalah `FAILED`)
`title`	string	Judul yang dihasilkan AI
`video_thumbnail`	string	URL thumbnail video
`summary`	string	Ringkasan teks lengkap
`tags`	string[]	Tagar yang dihasilkan AI
`highlights`	array	Segmen highlight timeline (lihat di bawah)
`cost_usage`	number	Kredit API yang digunakan untuk permintaan ini

Objek Highlight

Field	Tipe	Deskripsi
`start`	number	Waktu mulai dalam milidetik
`end`	number	Waktu berakhir dalam milidetik
`desc`	string	Judul / deskripsi bagian
`events`	array	Peristiwa kunci dalam highlight

Objek Event

Field	Tipe	Deskripsi
`timestamp`	number	Waktu peristiwa dalam milidetik
`desc`	string	Deskripsi peristiwa