# Seedance 2.5 Flash API Referensi API lengkap untuk model pembuat video Seedance 2.5 Flash dari ByteDance. ## Varian model API ini mendukung tiga varian model: | Model | ID | Deskripsi | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Pembuatan video berkualitas tinggi dari teks | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Pembuatan video dari bingkai awal atau dari bingkai awal dan akhir | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Pembuatan video dengan panduan gambar, video, dan audio referensi | ## Perbandingan singkat | Fitur | Teks ke video | Gambar ke video | Referensi ke video | |---------|---------------|----------------|--------------------| | Rentang durasi | 4–30 detik | 4–30 detik | 4–30 detik | | Pilihan resolusi | 480p, 720p | 480p, 720p | 480p, 720p | | Rasio aspek | Opsional (bawaan: 16:9) | Tidak didukung | Opsional (bawaan: 16:9) | | Media wajib | Tidak ada | Gambar bingkai awal | Tidak ada | | Media opsional | Tidak ada | Gambar bingkai akhir | Gambar, video, dan audio | ### Rasio aspek yang didukung Varian teks ke video dan referensi ke video mendukung rasio berikut: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` Varian gambar ke video tidak mendukung parameter `aspect_ratio`. ### Pilihan resolusi | Resolusi | Deskripsi | |------------|-------------| | `480p` | Definisi standar | | `720p` | Definisi tinggi | ## Seedance 2.5 Flash Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### Parameter permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Prompt untuk membuat video, maksimal 5000 karakter | | `resolution` | string | Resolusi keluaran: `"480p"` atau `"720p"`. Tidak ada nilai bawaan | | `duration` | integer | Durasi video dalam detik bulat dari 4 hingga 30, dengan kenaikan 1 detik. Tidak ada nilai bawaan | #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"`. Nilai bawaannya `"16:9"` | | `sound` | boolean | Menentukan apakah suara ikut dibuat. Nilai bawaannya `true`. Nilai `false` menghasilkan video tanpa suara | ### Contoh permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Parameter permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Prompt untuk membuat video, maksimal 5000 karakter | | `resolution` | string | Resolusi keluaran: `"480p"` atau `"720p"`. Tidak ada nilai bawaan | | `duration` | integer | Durasi video dalam detik bulat dari 4 hingga 30, dengan kenaikan 1 detik. Tidak ada nilai bawaan | | `image_url` | string | URL gambar bingkai awal. Lihat batas media di bawah. Rasio aspek keluaran mengikuti gambar ini | #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `image_end_url` | string | URL opsional untuk gambar bingkai akhir. Lihat batas media di bawah. Sebaiknya gunakan rasio aspek yang sama dengan bingkai awal | | `sound` | boolean | Menentukan apakah suara ikut dibuat. Nilai bawaannya `true`. Nilai `false` menghasilkan video tanpa suara | > Jangan sertakan `aspect_ratio` dalam permintaan gambar ke video. Model ini tidak mendukung parameter tersebut. ### Contoh permintaan ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Parameter permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Prompt untuk membuat video, maksimal 5000 karakter. Tulis prompt biasa tanpa penanda, atau gunakan fitur referensi @ (AT) dengan `<<>>`, `<<>>`, dan `<<>>` untuk merujuk secara eksplisit ke elemen dalam larik media masing-masing | | `resolution` | string | Resolusi keluaran: `"480p"` atau `"720p"`. Tidak ada nilai bawaan | | `duration` | integer | Durasi video dalam detik bulat dari 4 hingga 30, dengan kenaikan 1 detik. Tidak ada nilai bawaan | #### Media referensi Semua media referensi bersifat opsional. Permintaan dapat menggunakan gambar saja, video saja, audio saja, atau tanpa media referensi. Untuk membuat video tanpa referensi, sebaiknya gunakan varian teks ke video. | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `images` | string[] | 0–10 URL gambar referensi, dirujuk sesuai urutan dalam larik. Lihat batas media di bawah | | `videos` | string[] | 0–5 URL video referensi dalam format MP4 atau MOV. Setiap video harus berdurasi 2–30 detik dengan durasi gabungan maksimal 30 detik. Lihat batas media di bawah. Untuk penagihan, durasi total video referensi dibulatkan ke detik terdekat (setengah detik dibulatkan ke atas), lalu ditambahkan ke durasi video keluaran | | `audios` | string[] | 0–5 URL audio referensi dalam format WAV atau MP3. Setiap audio harus berdurasi 2–30 detik dan berukuran maksimal 15 MB. Durasi gabungannya tidak boleh melebihi 30 detik | #### Penanda referensi @ (AT) Fitur referensi @ (AT) menghubungkan media referensi dengan prompt melalui penanda bernomor `<<<...>>>`. Penomoran dimulai dari `1` untuk setiap jenis media secara terpisah dan mengikuti urutan larik masing-masing: | Penanda | Nilai yang dirujuk | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Misalnya, jika gambar pertama merupakan referensi karakter dan gambar kedua merupakan referensi latar, gunakan `<<>>` untuk karakter dan `<<>>` untuk latar di dalam `prompt`. Setiap penanda harus merujuk ke elemen yang ada dalam larik terkait. #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"`. Nilai bawaannya `"16:9"` | | `sound` | boolean | Menentukan apakah suara ikut dibuat. Nilai bawaannya `true`. Nilai `false` menghasilkan video tanpa suara | ### Contoh permintaan ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Contoh permintaan referensi ke video dengan @ (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Batas media Batas ini berlaku untuk gambar bingkai awal, gambar bingkai akhir, dan media referensi pada model di halaman ini. | Media | Format | Batas | |-------|---------|--------| | Gambar | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Ukuran setiap gambar harus kurang dari 30 MB. Lebar dan tinggi masing-masing harus 300–6000 piksel, dengan rasio lebar terhadap tinggi 0,4–2,5 | | Video | MP4, MOV | Maksimal 200 MB per video. Lebar dan tinggi masing-masing harus 300–6000 piksel, dengan rasio lebar terhadap tinggi 0,4–2,5, laju bingkai 24–60 FPS, dan jumlah piksel 407696–8295044 | | Audio | WAV, MP3 | Maksimal 15 MB per berkas | Audio dan video referensi masing-masing memiliki batas durasi gabungan tersendiri, yaitu 30 detik. Batas jumlahnya juga terpisah: maksimal 10 gambar, 5 video, dan 5 klip audio. Semua model mewajibkan `resolution` dan `duration` tanpa nilai bawaan. Jika `aspect_ratio` tidak disertakan, varian teks ke video dan referensi ke video menggunakan `16:9`. Nilai bawaan untuk suara adalah `true`. Gunakan `false` untuk menghasilkan video tanpa suara. ## Format respons ### Respons awal Semua model mengembalikan `task_id` untuk pemeriksaan status berkala: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Respons pemeriksaan status Kirim permintaan `GET /api/v1/video/{taskId}` secara berkala untuk memeriksa status: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Nilai status - `submitted`: Tugas diterima dan menunggu untuk diproses - `processing`: Video sedang dibuat - `succeed`: Pembuatan video selesai - `failed`: Pembuatan video gagal ## Waktu pemrosesan Waktu pemrosesan bergantung pada durasi, resolusi, dan kondisi antrean saat ini. Periksa status setiap 5–10 detik. ## Praktik terbaik 1. **Parameter wajib**: selalu sertakan `prompt`, `resolution`, dan `duration`. Untuk varian teks ke video dan referensi ke video, `aspect_ratio` bersifat opsional dengan nilai bawaan `16:9` 2. **Rasio gambar ke video**: jangan kirim `aspect_ratio` dalam permintaan gambar ke video 3. **Video referensi**: video bersifat opsional. Patuhi batas durasi yang ditetapkan untuk setiap video serta durasi gabungannya 4. **Gambar referensi**: gambar bersifat opsional, terlepas dari penggunaan video dan audio. Kirim maksimal 10 URL gambar yang didukung 5. **Audio referensi**: setiap klip audio harus berdurasi 2–30 detik dan berukuran maksimal 15 MB, dengan durasi gabungan maksimal 30 detik 6. **Urutan referensi**: susun `images`, `videos`, dan `audios` sesuai urutan yang diinginkan dan rujuk elemen-elemennya secara konsisten di dalam prompt 7. **Suara**: abaikan parameter `sound` untuk menggunakan nilai bawaan `true`, atau tetapkan nilainya ke `false` untuk menonaktifkan pembuatan suara