アップロード API

September 22, 2026

アップロード API

アップロード API を使うと、ローカル動画ファイルを WayinVideo にアップロードできます。アップロード後、返却されるファイル識別子を他の API エンドポイント（AI クリッピング、モーメント検索、動画要約、動画ノート、動画文字起こし）の video_url として使用します。

サブスクリプション必須： ローカルファイルのアップロードには Starter サブスクリプションプラン以上が必要です。プランごとのファイルサイズ・ストレージ制限は サブスクリプションプラン ページをご確認ください。

ファイルサイズ制限： 1 ファイルあたり最大 5 GB です。それ以上が必要な場合は wayinvideo@wayin.ai までご連絡ください。

対応フォーマット： 有効な動画ファイルをアップロードしてください。現在対応している形式は avi、mp4、mov、webm です。その他の形式をアップロードすると、タスク送信後の処理に失敗する場合があります。

アップロードの流れ

  1. リクエスト：ファイルのメタデータを提供してプリサインド URL を取得します
  2. アップロード：PUT リクエストでプリサインド URL に直接ファイルをアップロードします
  3. 使用：返却された identity 値を後続の API コールの video_url として使います

アップロード URL の取得

POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file

リクエストボディ

パラメータ型必須説明
namestringはい拡張子付きのファイル名（例："my-video.mp4"）
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"name": "sample-video.mp4"}'

レスポンス

{
  "data": {
    "upload_url": "https://storage.example.com/upload/presigned-url...",
    "identity": "file_abc123"
  }
}
フィールド型説明
upload_urlstringファイルアップロード用のプリサインド URL。1 時間で失効します。期限切れの場合は新しい URL を取得してください。
identitystring他の API の video_url として使用するファイル識別子

ファイルのアップロード

curl -X PUT "https://storage.example.com/upload/presigned-url..." \
  -H "Content-Type: video/mp4" \
  --data-binary @/Users/me/Videos/sample-video.mp4

注意： 同じ upload_url を使って再度アップロードすると、新しいファイルで上書きされます。1 ファイルの上限は 5 GB です。

アップロードしたファイルの使用

各 identity の有効期限は 24 時間です。クォータが十分あれば、24 時間以内に同じ identity を複数のタスクに使えます。

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

FAQ

ローカルファイルのアップロードとソース URL の指定はどう使い分ければよいですか？

動画が既に対応プラットフォーム（YouTube、Vimeo、TikTok、Zoom など）にある場合は、URL を処理エンドポイントに直接渡してください。アップロードは不要です。アップロード API は、対応ソースにまだホストされていないファイルに対してのみ使用してください。

アップロードできるファイルサイズの上限は？

1 ファイルあたり 5 GB です。それ以上が必要なユースケースの場合は wayinvideo@wayin.ai までご連絡ください。

対応しているファイル形式は？

mp4、mov、webm、avi。その他の形式では処理に失敗することがあります。

アップロードはプランのストレージクォータに含まれますか？

はい — アップロードされたファイルはサブスクリプションプランのストレージを消費します。プランごとのストレージ容量と 1 ファイルあたりのサイズ制限は サブスクリプションプラン を参照してください。

アップロードしたファイルを他の API で使うにはどうしますか？

アップロード後、返却されたファイル識別子を対応する処理エンドポイント（AI Clipping、Find Moments、Video Summarization、Video Notes、Video Transcription）の video_url フィールドとして渡してください。