アップロード API

アップロード API

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

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

ファイルサイズ制限： 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

リクエストボディ

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

ファイルのアップロード

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 Transcription）の video_url フィールドとして渡してください。