# 認証

> API リクエストの認証方法を確認しましょう。

## 認証

すべての API リクエストには、`Authorization` ヘッダーに Bearer トークン形式で有効な API キーを含める必要があります。また、`x-wayinvideo-api-version` ヘッダーも必須です：

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

## API キーの取得

1. [WayinVideo API ダッシュボード](https://wayin.ai/wayinvideo/api-dashboard)にログインします
2. **Create API Key** をクリックして新しいキーを生成します
3. API キーをコピーして安全に保管してください — 表示されるのは一度だけです

> **重要：** API キーは秘密にしてください。クライアントサイドのコードや公開リポジトリに含めないようにしましょう。キーが漏洩した疑いがある場合は、すぐに削除して新しいキーを発行してください。

## 認証済みリクエストの送信

すべてのリクエストに `Authorization` ヘッダーを含めてください：

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