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
identityyang dikembalikan sebagaivideo_urldalam 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
identityberlaku 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}'