クイックスタート

March 10, 2026

クイックスタート

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

1. API キーを取得する

  1. WayinVideo API ダッシュボードにログインします
  2. Create API Key をクリックして新しいキーを生成します
  3. API キーをコピーして安全な場所に保管します

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

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

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

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
  }'

レスポンス：

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

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

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

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"

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

{
  "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. 次のステップ