# 簡介

> WayinVideo API 功能總覽與核心能力介紹。

## 簡介

WayinVideo API 讓所有人都能將 AI 影片處理能力整合進自動化工作流程。無論影片長短，系統都能快速、穩定且高效地完成處理——包括長達數小時的影片——非常適合用於 Podcast、遊戲直播、網路研討會、教學課程、線上課程、訪談、會議、Vlog、城市漫步、體育賽事、電商影片、產品展示等各種內容製作流程。只需提交影片網址或上傳的檔案，即可獲得 AI 生成的短片、摘要、結構化筆記、逐字稿、增強影片等結果。

## API 列表

- **[AI 剪輯](https://wayin.ai/zh-tw/api-docs/ai-clipping/)**：提交任意長度的影片，自動偵測最具傳播潛力的片段，附帶精確的起止時間點、AI 生成的標題、描述與主題標籤，並可選擇匯出算好的影片。
- **[時刻搜尋](https://wayin.ai/zh-tw/api-docs/find-moments/)**：用自然語言描述你想找的片段，例如「好笑的反應」或「令人興奮的進球瞬間」，API 會迅速從各種長度的影片中找出符合條件的片段，附上時間點、標題與描述，並可選擇匯出算好的影片。
- **[社群媒體發布](https://wayin.ai/zh-tw/api-docs/social-media-publishing/)**：綁定社群媒體帳號，並將 AI 剪輯或時刻搜尋產生的短片發布到 YouTube、TikTok、Instagram、Facebook、X / Twitter、LinkedIn 等平台。
- **[影片摘要](https://wayin.ai/zh-tw/api-docs/video-summarization/)**：從任意長度的影片——包括數小時的長篇內容——生成結構化概覽、主題標籤與時間軸重點，處理快速且穩定。
- **[影片筆記](https://wayin.ai/zh-tw/api-docs/video-notes/)**：從影片生成可自訂的 AI 筆記，並同時取得 Markdown 與純文字格式的結果，以及結構化概覽、主題標籤與時間軸重點。
- **[影片轉錄](https://wayin.ai/zh-tw/api-docs/video-transcription/)**：從影片或音頻內容中提取字詞級別的逐字稿，並支援說話者分離（speaker diarization）。
- **[影片增強](https://wayin.ai/zh-tw/api-docs/video-enhancer/)**：將平台上的影片檔或已上傳的檔案增強至 1080p、2K 或 4K。可選擇強化畫面文字，並處理整支影片或最長 10 分鐘的片段。
- **[AI for Stream Videos](https://wayin.ai/solutions/stream)**：WayinVideo 的世界領先 AI 能即時理解世界，並與你一起主動探索，支援直播理解與剪輯，同時作為 AI 硬體與機器人的大腦。若要申請使用，請前往[這裡](https://wayin.ai/solutions/stream/#solution-contact-form)聯絡銷售團隊。

## 支援的影片來源

API 接受以下平台的網址：

- YouTube
- Vimeo
- Dailymotion
- Kick
- Rumble
- Zoom
- Twitch
- TikTok
- Facebook

更多平台持續新增中。

你也可以處理[本機上傳的影片或音頻檔案](https://wayin.ai/zh-tw/api-docs/upload/)。

## Base URL

所有 API 請求均發送至：

```
https://wayinvideo-api.wayin.ai/api/v2
```

## 請求格式

API 採用 RESTful 架構，接受 JSON 格式的請求本體。所有請求必須包含以下 Headers：

```
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2
```

## 回應格式

### 成功（HTTP 200）

請求成功時，API 回傳 HTTP 狀態碼 **200**，回應本體為 JSON，資料內容包裝在 `data` 欄位中：

```json
{
  "data": {
    "project_id": "prj06928fdjqqaza",
    "name": "Sample project name",
    "status": "SUCCEEDED"
  }
}
```

`data` 的結構依端點而異，詳情請參閱各 API 的說明文件。錯誤回應與其他 HTTP 狀態碼，請參閱 [狀態碼](https://wayin.ai/zh-tw/api-docs/status-codes/)。

## 任務狀態週期

許多端點會以非同步方式回傳處理狀態，生命週期如下：

```
CREATED → QUEUED → ONGOING → SUCCEEDED / FAILED
```

請持續輪詢狀態直到出現 `SUCCEEDED` 或 `FAILED`。任務失敗時，回應 `data` 中會包含 `error_message` 欄位說明原因。