動画要約 API

動画要約 API

任意の長さの動画を送信すると、AI が生成した構造化されたオーバービュー、ハッシュタグ、タイムラインハイライトを取得できます。短尺動画から数時間の長尺コンテンツまで、主要プラットフォームおよびローカルアップロードファイルに対応しています。

対応動画ソース

YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble など。

アップロードしたローカル動画・音声ファイルも要約できます — ローカルアップロードには Standard プラン以上が必要です。

ワークフロー

1. 送信：動画 URL から要約タスクを送信します
2. ポーリング：SUCCEEDED になるまで結果を取得し続けます

要約タスクの送信

POST https://wayinvideo-api.wayin.ai/api/v2/summaries

リクエストボディ

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -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", "target_lang": "en"}'

import requests

requests.post(
    "https://wayinvideo-api.wayin.ai/api/v2/summaries",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "x-wayinvideo-api-version": "v2",
    },
    json={
        "video_url": "https://www.youtube.com/watch?v=example",
        "target_lang": "en",
    },
)

await fetch("https://wayinvideo-api.wayin.ai/api/v2/summaries", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "x-wayinvideo-api-version": "v2",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    video_url: "https://www.youtube.com/watch?v=example",
    target_lang: "en",
  }),
});

レスポンス

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

使用例

代表的な要約のシナリオです。YOUR_API_KEY は API ダッシュボード で取得したキーに置き換えてください。

YouTube 動画を要約する

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'

長尺ポッドキャストエピソードを要約する

数時間に及ぶポッドキャストでも同じ方法で送信・ポーリングできます。レスポンスにはタイムラインハイライトが含まれるため、長時間の音声を素早くナビゲートできます。

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://www.youtube.com/watch?v=EXAMPLE"}'

ウェビナーを別の言語で要約する

target_lang を指定すると、ソース動画と異なる言語でも、要約、ハイライト、説明を目的の言語に翻訳できます。

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "source_lang": "en",
    "target_lang": "ja"
  }'

要約結果の取得

GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/{id}

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

レスポンス

{
  "data": {
    "status": "SUCCEEDED", "title": "sample title",
    "video_thumbnail": "https://cdn.example.com/thumb/video_001.jpg",
    "summary": "sample summary text", "tags": ["#topic1", "#topic2"],
    "highlights": [{"start": 0, "end": 196000, "desc": "sample section title",
                    "events": [{"timestamp": 160, "desc": "sample event"}]}],
    "cost_usage": 54.0
  }
}

レスポンスフィールド

ハイライトオブジェクト

イベントオブジェクト

FAQ

動画の最大長さは？

長さの厳密な制限はありません。本 API は短いクリップから長尺動画まで対応しており、ポッドキャストエピソード、フル尺ウェビナー、講義録画、ライブ配信のアーカイブなども処理できます。

要約レスポンスには何が含まれますか？

構造化された概要、ハッシュタグ、開始・終了タイムスタンプと説明を持つハイライトセグメントのタイムラインが含まれます。ハイライトを使ってタイムライン UI を描画したり、チャプターマーカーを自動生成したりできます。

ソース動画と異なる言語で要約を取得できますか？

はい — target_lang を指定すると、ソース動画と異なる言語でも概要、説明、ハイライトが目的の言語に翻訳されます。

どの動画ソースに対応していますか？

YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble などの URL、加えて アップロード API によるローカルファイルアップロードに対応しています。