AI クリッピング API
任意の長さの動画を送信すると、バイラルポテンシャルでランク付けされたクリップをすべて取得できます。各クリップには自動検出された開始・終了タイムスタンプ、AI 生成のタイトル・説明・ハッシュタグが含まれます。エクスポートを有効にした場合、AI リフレームとアニメーション字幕付きのレンダリング済み動画ダウンロードリンクも含まれます。
対応動画ソース
YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble など。
アップロードしたローカル動画ファイルもクリップ可能です — ローカルアップロードには Standard プラン以上が必要です。
クリッピングタスクの送信
POST https://wayinvideo-api.wayin.ai/api/v2/clips
リクエストボディ
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
video_url | string | はい | — | ソース動画の URL または アップロード API が返したファイル識別子。 |
project_name | string | いいえ | "" | タスクのカスタム名 |
source_lang | string | いいえ | null | 動画のソース言語（対応言語参照）。null の場合は自動検出。 |
target_lang | string | いいえ | null | タイトル・説明・字幕の出力言語。null の場合は source_lang と同じ。 |
target_duration | string | いいえ | DURATION_0_90 | クリップの目標時間：DURATION_0_30、DURATION_0_90、DURATION_30_60、DURATION_60_90、DURATION_90_180、DURATION_180_300。 |
limit | number | いいえ | null | 返却するクリップの最大数。null の場合はすべて返却。 |
enable_export | boolean | いいえ | false | false：メタデータのみ；true：即時レンダリングしダウンロードリンクを返却。 |
resolution | string | いいえ | SD_480 | 出力解像度：SD_480、HD_720、FHD_1080、QHD_2K、UHD_4K。enable_export が true のときのみ有効。 |
enable_caption | boolean | いいえ | false | レンダリング時にアニメーション字幕を追加。enable_export が true のときのみ有効。 |
caption_display | string | いいえ | original | 字幕モード：both、original、translation。 |
cc_style_tpl | string | いいえ | temp-7 | 字幕スタイルテンプレート ID（字幕スタイル参照）。 |
enable_ai_hook | boolean | いいえ | false | 各クリップの冒頭または末尾に AI 生成の注目テキストを追加。 |
ai_hook_script_style | string | いいえ | serious | フックテキストのスタイル：serious、casual、informative、conversational、humorous、parody、inspirational、dramatic、empathetic、persuasive、neutral、excited、calm。 |
ai_hook_position | string | いいえ | beginning | 位置：beginning、end。 |
enable_ai_reframe | boolean | いいえ | false | AI リフレームを有効化。true の場合 ratio が必須。 |
ratio | string | enable_ai_reframe が true のとき必須 | — | アスペクト比：RATIO_9_16、RATIO_1_1、RATIO_4_5、RATIO_16_9。 |
reframe_layout | string | いいえ | Auto | AI リフレームのレイアウト。レイアウト値セクション参照。 |
enable_more_results | boolean | いいえ | false | より多くのクリップを生成。Enterprise サブスクリプション限定。 |
enable_express_mode | boolean | いいえ | false | エクスプレスモード：API ユニット消費量が通常の半分。Enterprise サブスクリプション限定。 |
リフレームレイアウト値
ratio | 指定可能な reframe_layout 値 |
|---|---|
RATIO_16_9 | Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, OTS, Screen First |
RATIO_9_16 | Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, Screen First, Gameplay A, Gameplay B |
RATIO_1_1 | Auto, Full, Fit, Grid 4, Trio |
RATIO_4_5 | Auto, Full, Fit, Grid 4, Split 2, Trio, PiP, Screen First, Gameplay A, Gameplay B |
enable_export を true に設定。クリップがレンダリングされ、各クリップに export_link が含まれます。
リクエスト
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", "target_duration": "DURATION_30_60", "enable_export": true, "resolution": "HD_720", "enable_caption": true, "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'
送信レスポンス
{"data": {"id": "proj_xyz789", "name": "sample project name", "status": "CREATED"}}
enable_export を省略または false に設定。メタデータのみ返却。レンダリングなし。
リクエスト
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", "target_duration": "DURATION_30_60"}'
送信レスポンス
{"data": {"id": "proj_abc123", "name": "sample project name", "status": "CREATED"}}
使用例
代表的な AI クリッピングのシナリオです。YOUR_API_KEY は API ダッシュボード で取得したキーに置き換えてください。
YouTube 動画をバイラルクリップに変換
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
-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"}'
ウェビナー録画を字幕付きの縦型 9:16 ショートに変換
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
-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_duration": "DURATION_30_60",
"enable_export": true,
"resolution": "HD_720",
"enable_caption": true,
"enable_ai_reframe": true,
"ratio": "RATIO_9_16"
}'
ポッドキャストから上位スコアのショート動画を取得
長尺コンテンツから、最もバイラルポテンシャルの高いクリップのみを取得したい場合に便利です。
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
-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",
"limit": 5,
"target_duration": "DURATION_60_90",
"enable_export": true,
"resolution": "HD_720",
"enable_caption": true,
"enable_ai_reframe": true,
"ratio": "RATIO_9_16"
}'
クリッピング結果の取得
GET https://wayinvideo-api.wayin.ai/api/v2/clips/results/{id}
インクリメンタル結果：
statusがONGOINGの間、各呼び出しはその時点で生成済みのクリップを返します。
{"data": {"id": "proj_xyz789", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
"clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
"tags": ["insight"], "desc": "sample description", "score": 81,
"export_link": "https://cdn.example.com/export/clip_001.mp4"}]}}
{"data": {"id": "proj_abc123", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
"clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
"tags": ["insight"], "desc": "sample description", "score": 81}]}}
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
id | string | タスクの一意な識別子 |
name | string | タスク名 |
status | string | CREATED, QUEUED, ONGOING, SUCCEEDED, FAILED |
error_message | string | エラーの理由（FAILED のときのみ） |
expire_at | integer | 有効期限のタイムスタンプ（ミリ秒） |
cost_usage | number | 消費した API ユニット数 |
clips | array | クリップオブジェクトのリスト |
クリップオブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
idx | integer | クリップのインデックス（0 始まり、バイラルポテンシャル順） |
title | string | AI 生成のタイトル |
begin_ms | number | 開始時刻（ミリ秒） |
end_ms | number | 終了時刻（ミリ秒） |
thumbnail | string | サムネイル URL |
tags | string[] | AI 生成のハッシュタグ |
desc | string | AI 生成の説明 |
score | number | バイラルポテンシャルスコア（0–100） |
export_link | string | レンダリング済み動画のダウンロード URL。24 時間で失効します。 |
既存クリップの再エクスポート
後からレンダリングしたり、別の設定で再エクスポートしたりするには クリップエクスポート API をご利用ください。
FAQ
動画の最大長さは？
長さの厳密な制限はありません — ポッドキャスト、ゲーム配信、ウェビナーなど数時間に及ぶコンテンツを想定して設計されています。ファイルサイズの制限は ローカルアップロード のみに適用され、URL ベースのソースには上限がありません。
クリップはどのようにランク付けされますか？
各クリップはバイラルポテンシャル（ストーリーの完結度、フックの強さ、感情のピーク、エンゲージメント指標）でスコアリングされます。limit パラメーターを使うとスコア上位 N 件のみを残せます。
レンダリングせずにクリップを取得できますか？
はい。enable_export を省略（または false に設定）することで、タイムスタンプ、タイトル、説明、タグのみを取得できます。選択したクリップを後から クリップエクスポート API でレンダリングできます。
AI Reframe はどのアスペクト比に対応していますか？
RATIO_9_16（TikTok / Reels / Shorts）、RATIO_1_1（Instagram フィード）、RATIO_4_5（Instagram ポートレート）、RATIO_16_9（横向き）に対応しています。各比率のレイアウトオプションは リフレームレイアウト値 を参照してください。
どのプラットフォームからクリップできますか？
YouTube、Vimeo、Dailymotion、Kick、Twitch、TikTok、Facebook、Zoom、Rumble など。加えて、ローカルアップロードされたファイル（mp4、mov、webm、avi）にも対応しています。