Video Summarization API – AI 影片概覽與時間軸重點

影片摘要 API

提交任意長度的影片，取得 AI 生成的結構化概覽、主題標籤與時間軸重點。API 支援從短片到數小時長片的各種內容，涵蓋主流平台影片與本機上傳檔案，並支援語言設定。

支援的影片來源

API 接受以下平台的網址：YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble 等。

也可以摘要本機上傳的影片或音頻檔案——本機上傳需要 Standard 方案或以上。

工作流程

提交：從影片網址提交摘要任務
輪詢：持續取得結果，直到狀態變為 SUCCEEDED

提交摘要任務

提交一個新的摘要任務，這是所有摘要功能的入口。

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

請求本體

參數	類型	必填	預設值	說明
`video_url`	string	是	—	來源影片的網址或上傳的檔案識別碼
`source_lang`	string	否	`null`	影片的來源語言（參見支援語言）。為 `null` 時，系統自動偵測原始語言。
`target_lang`	string	否	`null`	輸出內容（含摘要、描述與重點）的目標語言（參見支援語言）。為 `null` 時，輸出語言與 `source_lang` 相同。

請求範例

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

import requests

requests.post(
    "https://wayinvideo-api.wayin.ai/api/v2/summaries",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-wayinvideo-api-version": "v2",
    },
    json={
        "video_url": "https://www.youtube.com/watch?v=example",
        "target_lang": "en",
    },
)

await fetch("https://wayinvideo-api.wayin.ai/api/v2/summaries", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "x-wayinvideo-api-version": "v2",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    video_url: "https://www.youtube.com/watch?v=example",
    target_lang: "en",
  }),
});

回應

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

欄位	類型	說明
`id`	string	任務識別碼（用於後續請求）
`name`	string	任務名稱
`status`	string	`CREATED`、`QUEUED`、`ONGOING`、`SUCCEEDED`、`FAILED`

使用範例

常見的摘要情境。請將 YOUR_API_KEY 替換為從 API Dashboard 取得的金鑰。

摘要 YouTube 影片

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'

摘要長篇 Podcast 集數

數小時的 Podcast 處理方式相同——提交後輪詢即可。回應包含時間軸重點，方便快速瀏覽數小時的音頻。

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'

以其他語言摘要網路研討會

設定 target_lang 即可在來源影片為不同語言時，將摘要、重點與描述翻譯為目標語言。

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "source_lang": "en",
    "target_lang": "ja"
  }'

取得摘要結果

取得摘要、重點與標籤。持續輪詢，直到 status 為 SUCCEEDED。

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

路徑參數

參數	類型	必填	說明
`id`	string	是	提交端點回傳的任務 ID

請求範例

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"

回應

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

摘要回應欄位

欄位	類型	說明
`status`	string	`CREATED`、`QUEUED`、`ONGOING`、`SUCCEEDED`、`FAILED`
`error_message`	string	錯誤原因（僅在 `status` 為 `FAILED` 時出現）
`title`	string	AI 生成的標題
`video_thumbnail`	string	影片縮圖網址
`summary`	string	完整的文字概覽
`tags`	string[]	AI 生成的主題標籤
`highlights`	array	時間軸重點段落（詳見下方）
`cost_usage`	number	此次請求消耗的 API 點數

重點段落物件

欄位	類型	說明
`start`	number	起始時間（毫秒）
`end`	number	結束時間（毫秒）
`desc`	string	段落標題 / 描述
`events`	array	段落內的關鍵事件

事件物件

欄位	類型	說明
`timestamp`	number	事件時間（毫秒）
`desc`	string	事件描述

常見問題

影片最長可以多長？

沒有硬性的長度限制。API 支援短片和長影片，包括 Podcast 集數、完整網路研討會、講座錄影與直播回放。

摘要回應包含哪些內容？

結構化概覽、主題標籤，以及含起止時間點與描述的時間軸重點段落。重點段落能輕鬆建構時間軸 UI 或自動產生章節標記。

可以取得與來源語言不同的摘要嗎？

可以——傳入 target_lang 即可在來源影片為不同語言時，將概覽、描述與重點翻譯為目標語言。

支援哪些影片來源？

YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble 等網址，以及透過上傳 API上傳的本機檔案。