# クイックスタート

> 数分で WayinVideo API を使い始めましょう。

## クイックスタート

以下の手順に従えば、数分で WayinVideo API を使い始めることができます。

## 1. API キーを取得する

1. [WayinVideo API ダッシュボード](https://wayin.ai/wayinvideo/api-dashboard)にログインします
2. **Create API Key** をクリックして新しいキーを生成します
3. API キーをコピーして安全な場所に保管します

> **重要：** API キーは秘密にしてください。クライアントサイドのコードや公開リポジトリに含めないようにしましょう。

## 2. クリッピングタスクを送信する

動画 URL を送信して AI クリッピングタスクを開始します：

```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",
    "enable_export": false
  }'
```

レスポンス：

```json
{
  "data": {
    "id": "proj_abc123",
    "name": "sample project name",
    "status": "CREATED"
  }
}
```

## 3. 結果をポーリングする

`SUCCEEDED` になるまでタスクのステータスをポーリングします。**30 秒**ごとのポーリングを推奨します。

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/proj_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

完了すると、レスポンスにクリップが含まれます：

```json
{
  "data": {
    "id": "proj_abc123",
    "status": "SUCCEEDED",
    "clips": [
      {
        "idx": 0,
        "title": "sample title",
        "begin_ms": "15000",
        "end_ms": "75000",
        "tags": ["insight", "analysis"],
        "desc": "sample description"
      }
    ]
  }
}
```

> **注意：** クリッピングタスク送信時に `enable_export = true` を設定すると、サービスが動画をレンダリング・エクスポートし、ダウンロードリンクを返します。レンダリングには追加の処理時間が必要なため、完了まで通常より時間がかかります。

## 4. クリップのエクスポートと公開

クリップ生成後、動画ファイルとしてレンダリングしたり、接続済みのソーシャルメディアアカウントへ直接公開したりできます。

- [クリップエクスポート API](https://wayin.ai/ja/api-docs/clips-export/) — 解像度、字幕、AI リフレーム、AI Hook などの設定を指定して、クリップをレンダリングまたは再エクスポートします。
- [ソーシャルメディア公開 API](https://wayin.ai/ja/api-docs/social-media-publishing/) — ソーシャルメディアアカウントを接続し、AI クリッピングまたはモーメント検索で生成したクリップを公開します。

## 次のステップ

- [AI クリッピング](https://wayin.ai/ja/api-docs/ai-clipping/) — 長尺動画からバイラルクリップを取得
- [モーメント検索](https://wayin.ai/ja/api-docs/find-moments/) — 自然言語で動画内のモーメントを検索
- [動画要約](https://wayin.ai/ja/api-docs/video-summarization/) — オーバービューとタイムラインハイライトを取得
- [動画ノート](https://wayin.ai/ja/api-docs/video-notes/) — Markdown 形式とプレーンテキスト形式の構造化 AI ノートを生成
- [動画文字起こし](https://wayin.ai/ja/api-docs/video-transcription/) — 話者分離付きの単語レベル文字起こしを抽出
- [AI for Stream Videos](https://wayin.ai/solutions/stream) — リアルタイム動画ワークフロー向けの Live Stream Understanding and Clipping を確認します。