Unggah File Lokal untuk AI Clipping, Summarization & Transcription

Upload API

Upload API memungkinkan Anda mengunggah file video atau audio lokal ke WayinVideo. Setelah diunggah, gunakan identifier file yang dikembalikan sebagai video_url di endpoint API lainnya.

Langganan Diperlukan: Unggah file lokal memerlukan paket Standard atau lebih tinggi. Batas Ukuran File: Batas ukuran file tunggal: 5 GB. Format yang didukung: avi, mp4, mov, webm.

Alur Unggah

Minta pre-signed URL unggah dengan menyediakan metadata file
Unggah file langsung ke pre-signed URL menggunakan permintaan PUT
Gunakan nilai identity yang dikembalikan sebagai video_url dalam panggilan API berikutnya

Dapatkan URL Unggah

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

Body Permintaan

Parameter	Tipe	Wajib	Deskripsi
`name`	string	Ya	Nama file beserta ekstensinya (mis. `"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"}'

Respons

{"data": {"upload_url": "https://storage.example.com/upload/presigned-url...", "identity": "file_abc123"}}

Field	Tipe	Deskripsi
`upload_url`	string	Pre-signed URL untuk mengunggah. Kedaluwarsa setelah 1 jam.
`identity`	string	Identifier file untuk digunakan sebagai `video_url` di API lainnya

Unggah File

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

Gunakan File yang Diunggah

Setiap identity berlaku selama 24 jam.

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

Kapan saya harus mengunggah file lokal vs. menggunakan URL sumber?

Jika video Anda sudah ada di platform yang didukung (YouTube, Vimeo, TikTok, Zoom, dll.), berikan URL langsung ke endpoint pemrosesan — tidak perlu mengunggah. Gunakan Upload API hanya untuk file yang belum di-hosting di sumber yang didukung.

Berapa ukuran file unggahan maksimum?

5 GB per file. Hubungi wayinvideo@wayin.ai jika kasus penggunaan Anda memerlukan batas yang lebih tinggi.

Format file apa saja yang didukung?

mp4, mov, webm, avi. File audio-saja harus di-mux ke salah satu format kontainer ini sebelum diunggah. Format lain mungkin gagal saat pemrosesan.

Apakah unggahan dihitung terhadap kuota penyimpanan paket saya?

Ya — file yang diunggah memakai penyimpanan pada paket langganan Anda. Lihat Paket Langganan untuk batas penyimpanan per-paket dan ukuran per-file.

Bagaimana cara menggunakan file yang diunggah di panggilan API lain?

Setelah diunggah, berikan identifier file yang dikembalikan sebagai field video_url pada endpoint pemrosesan mana pun — AI Clipping, Find Moments, Video Summarization, atau Video Transcription.