Upload API

September 22, 2026

Upload API

Upload API memungkinkan Anda mengunggah file video lokal ke WayinVideo. Setelah mengunggah, gunakan identifier file yang dikembalikan sebagai video_url di endpoint API lainnya (AI Clipping, Find Moments, Video Summarization, Video Notes, Video Transcription).

Langganan Diperlukan: Unggah file lokal memerlukan paket Starter atau lebih tinggi. Setiap paket langganan memiliki batas ukuran file individual dan total penyimpanan yang berbeda. Lihat halaman Paket Langganan untuk detailnya.

Batas Ukuran File: Batas ukuran satu file untuk unggahan lokal adalah 5 GB. Jika Anda memerlukan batas yang lebih tinggi, hubungi kami di wayinvideo@wayin.ai.

Format yang didukung: Anda harus mengunggah file video yang valid. Format yang saat ini didukung: avi, mp4, mov, webm. Mengunggah format lain dapat menyebabkan pemrosesan tugas gagal setelah dikirim.

Alur Unggah

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

Dapatkan URL Unggah

Minta URL unggah sementara untuk file lokal.

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

Body Permintaan

ParameterTipeWajibDefaultDeskripsi
namestringYa—Nama file beserta ekstensinya (mis. "my-video.mp4")

Contoh Permintaan

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"
  }
}
FieldTipeDeskripsi
upload_urlstringURL pre-signed untuk mengunggah file. URL ini kedaluwarsa setelah 1 jam — selesaikan unggahan dalam waktu tersebut. Jika kedaluwarsa, minta URL baru.
identitystringIdentifier file yang digunakan sebagai video_url di API lainnya

Unggah File

Gunakan upload_url untuk mengunggah file Anda dengan permintaan PUT. Karakter @ pada --data-binary diikuti oleh path file lokal:

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

Catatan: Jika Anda mengunggah lagi menggunakan upload_url yang sama, file baru akan menimpa file sebelumnya. Setiap file tidak boleh melebihi 5 GB.

Gunakan File yang Diunggah

Setelah mengunggah, berikan nilai identity sebagai video_url saat mengirim tugas.

Catatan: Setiap identity berlaku selama 24 jam. Jika kuota Anda mencukupi, Anda dapat menggunakan identity yang sama untuk mengirim beberapa tugas dalam waktu 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. 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 yang didukung — AI Clipping, Find Moments, Video Summarization, Video Notes, atau Video Transcription.