Upload API

April 1, 2026

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

  1. Minta pre-signed URL unggah dengan menyediakan metadata file
  2. Unggah file langsung ke pre-signed URL menggunakan permintaan PUT
  3. 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

ParameterTipeWajibDeskripsi
namestringYaNama 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"}}
FieldTipeDeskripsi
upload_urlstringPre-signed URL untuk mengunggah. Kedaluwarsa setelah 1 jam.
identitystringIdentifier 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}'