驗證

March 10, 2026

驗證

所有 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
  2. 點擊 Create API Key 生成新的金鑰
  3. 複製並妥善保存你的 API 金鑰——金鑰只會顯示一次

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

發送已驗證的請求

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

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。回應本體範例：

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