# 驗證

> 了解如何對 API 請求進行驗證。

## 驗證

所有 API 請求都必須在 `Authorization` Header 中使用 Bearer Token 格式帶入有效的 API 金鑰，同時也需要加上 `x-wayinvideo-api-version` Header：

```
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2
```

## 取得 API 金鑰

1. 登入 [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard)
2. 點擊 **Create API Key** 生成新的金鑰
3. 複製並妥善保存你的 API 金鑰——金鑰只會顯示一次

> **重要：** API 金鑰屬於機密資訊，絕對不要在前端程式碼或公開的程式碼庫中暴露。若懷疑金鑰已外洩，請立即刪除並重新建立一組新的金鑰。

## 發送已驗證的請求

每次請求都需要帶上 `Authorization` Header：

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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"}'
```

## 錯誤回應

驗證失敗時，API 會回傳 **403 Forbidden**。回應本體範例：

```json
{
  "timestamp": "2026-03-13T07:58:46.156+00:00",
  "status": 403,
  "error": "Forbidden",
  "path": "/api/v2/clips"
}
```