# Seedance 2.0 API Referensi API lengkap untuk model pembuatan video Seedance 2.0 dari ByteDance. ## Varian Model API ini mendukung enam varian model: | Model | ID | Deskripsi | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | Pembuatan video berkualitas tinggi dari teks | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | Animasi gambar dengan kontrol gerakan | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | Pembuatan video dengan panduan video referensi | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | Pembuatan video dari teks yang lebih cepat | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | Pembuatan video dari gambar yang lebih cepat | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | Pembuatan video berpanduan referensi yang lebih cepat | ## Perbandingan Singkat | Fitur | Model Standar | Model Fast | |---------|-----------------|-------------| | Kualitas | Kualitas lebih tinggi | Dioptimalkan untuk kecepatan | | Waktu Pemrosesan | 3-8 menit | 1-4 menit | | Rentang Durasi | 4-15 detik | 4-15 detik | | Pilihan Resolusi | 480p, 720p, 1080p, 4k | 480p, 720p | | Media Referensi | Gambar, video, dan audio untuk Reference-to-Video | Gambar, video, dan audio untuk Fast Reference-to-Video | ### Rasio Aspek yang Didukung `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### Pilihan Resolusi | Resolusi | Deskripsi | |------------|-------------| | `480p` | Definisi standar, pemrosesan lebih cepat | | `720p` | Definisi tinggi, keseimbangan kualitas dan kecepatan | | `1080p` | Full HD, tersedia untuk semua model Seedance 2.0 standar | | `4k` | Ultra HD, tersedia untuk semua model Seedance 2.0 standar | ## Seedance 2.0 Teks ke Video ### Titik Akhir ``` POST /api/v1/video/task ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.0-text-to-video"` | | `prompt` | string | Prompt pembuatan video | | `duration` | integer | Durasi video dalam detik bulat (4-15), dengan langkah 1 | | `resolution` | string | Resolusi keluaran: `"480p"`, `"720p"`, `"1080p"`, atau `"4k"` | | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"` | #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `sound` | boolean | Apakah suara dibuat. Nilai bawaan `true`; tidak memengaruhi harga | ### 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.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 Gambar ke Video ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.0-image-to-video"` | | `prompt` | string | Prompt pembuatan video | | `duration` | integer | Durasi video dalam detik bulat (4-15), dengan langkah 1 | | `resolution` | string | Resolusi keluaran: `"480p"`, `"720p"`, `"1080p"`, atau `"4k"` | | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"` | | `image_url` | string | Bingkai pertama video | #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `image_end_url` | string | URL gambar bingkai akhir opsional | | `sound` | boolean | Apakah suara dibuat. Nilai bawaan `true`; tidak memengaruhi harga | ### Contoh Permintaan ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 Referensi ke Video ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.0-reference-to-video"` | | `prompt` | string | Prompt pembuatan video. Tulis prompt standar tanpa penanda, atau gunakan fitur referensi @ (AT) dengan `<<>>`, `<<>>`, dan `<<>>` untuk merujuk item dalam array media terkait secara eksplisit | | `duration` | integer | Durasi video dalam detik bulat (4-15), dengan langkah 1 | | `resolution` | string | Resolusi keluaran: `"480p"`, `"720p"`, `"1080p"`, atau `"4k"` | | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"` | #### Media Referensi Kirim 1-9 gambar. Gambar hanya boleh dihilangkan jika setidaknya satu video referensi disediakan. | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `images` | string[] | 1-9 URL gambar referensi, atau array kosong jika `videos` tidak kosong | | `videos` | string[] | Maksimal 3 URL video referensi; setiap video harus berdurasi 2-15 detik, dengan total durasi maksimal 15 detik | | `audios` | string[] | Maksimal 3 URL audio referensi; setiap klip harus berdurasi 2-15 detik, dengan total durasi maksimal 15 detik; WAV atau MP3, maksimal 15 MB per klip; memerlukan setidaknya satu gambar atau video | #### Penanda Referensi @ (AT) Fitur referensi @ (AT) menghubungkan media referensi ke prompt melalui penanda bernomor `<<<...>>>`. Penomoran dimulai dari `1` secara terpisah untuk setiap jenis media dan mengikuti urutan array terkait: | Penanda | Nilai yang Dirujuk | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Misalnya, jika gambar pertama adalah referensi karakter dan gambar kedua adalah referensi adegan, gunakan `<<>>` untuk karakter dan `<<>>` untuk adegan dalam `prompt`. Setiap penanda harus menunjuk ke item yang ada dalam array terkait. #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `sound` | boolean | Apakah suara tersinkron dibuat. Nilai bawaan `true` | ### Contoh Permintaan ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', 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.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Varian Fast Varian Fast mengutamakan kecepatan pemrosesan. Semua model Fast hanya mendukung keluaran `"480p"` dan `"720p"`. Struktur permintaan Fast Teks ke Video dan Fast Gambar ke Video lainnya mengikuti model standar masing-masing, sedangkan Fast Referensi ke Video menggunakan batas media referensi yang sama dengan model referensi standar. ### Contoh Permintaan Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', 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 Fast Referensi ke Video dengan @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### Parameter Seedance 2.0 Fast Referensi ke Video #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | Prompt pembuatan video. Tulis prompt standar tanpa penanda, atau gunakan fitur referensi @ (AT) dengan `<<>>`, `<<>>`, dan `<<>>` untuk merujuk item dalam array media terkait secara eksplisit | | `duration` | integer | Durasi video dalam detik bulat (4-15), dengan langkah 1 | | `resolution` | string | Resolusi keluaran: `"480p"` atau `"720p"` | | `aspect_ratio` | string | Rasio aspek video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, atau `"3:4"` | #### Media Referensi | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `images` | string[] | 1-9 URL gambar referensi, atau array kosong jika `videos` tidak kosong | | `videos` | string[] | Maksimal 3 URL video referensi; setiap video harus berdurasi 2-15 detik, dengan total durasi maksimal 15 detik | | `audios` | string[] | Maksimal 3 URL audio referensi; setiap klip harus berdurasi 2-15 detik, dengan total durasi maksimal 15 detik; WAV atau MP3, maksimal 15 MB per klip; memerlukan setidaknya satu gambar atau video | Aturan penanda yang dimulai dari 1 di atas juga berlaku untuk model Fast Referensi ke Video. #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `sound` | boolean | Apakah suara tersinkron dibuat. Nilai bawaan `true` | ## Batas Media Batas ini berlaku untuk gambar bingkai pertama, gambar bingkai terakhir, dan media referensi model pada halaman ini. | Media | Format | Batas | |-------|---------|--------| | Gambar | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Setiap gambar harus lebih kecil dari 30 MB; lebar dan tinggi masing-masing 300-6000 px; rasio lebar terhadap tinggi 0.4-2.5 | | Video | MP4, MOV | Maksimal 200 MB per file; lebar dan tinggi masing-masing 300-6000 px; rasio lebar terhadap tinggi 0.4-2.5; laju bingkai 24-60 FPS | | Audio | WAV, MP3 | Maksimal 15 MB per file | | Isi permintaan | — | Maksimal 64 MB | Audio referensi dan video referensi masing-masing memiliki batas total durasi terpisah sebesar 15 detik. Jumlahnya independen: maksimal 9 gambar, 3 video, dan 3 klip audio. Menambahkan video tidak mengurangi jumlah gambar yang diizinkan. Semua model menggunakan `720p` secara bawaan, tetapi `resolution` tetap wajib diberikan. Sakelar suara bernilai bawaan `true`; baik sakelar ini maupun audio referensi tidak mengubah harga. Referensi ke Video memerlukan setidaknya satu gambar atau video; permintaan yang hanya berisi audio tidak didukung. Mengunggah video referensi menggandakan biaya pembuatan, terlepas dari jumlah atau durasinya. ## Format Respons ### Respons Awal Semua model mengembalikan `task_id` untuk pemeriksaan 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 Berkala Periksa `GET /api/v1/video/{taskId}` secara berkala untuk mengetahui 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 pemrosesan - `processing`: pembuatan video sedang berlangsung - `succeed`: pembuatan video selesai - `failed`: pembuatan video gagal ## Waktu Pemrosesan **Model Standar**: 3-8 menit, tergantung durasi dan resolusi. **Model Fast**: 1-4 menit untuk sebagian besar konfigurasi. Periksa status setiap 5-10 detik. ## Praktik Terbaik 1. **Pilih Varian yang Tepat**: gunakan model Fast untuk iterasi dan model standar untuk hasil akhir 2. **Jelaskan Gerakan dengan Jelas**: sertakan deskripsi gerakan spesifik dalam prompt 3. **Pemilihan Resolusi**: semua model Seedance 2.0 standar mendukung `480p`, `720p`, `1080p`, dan `4k`; semua model Fast hanya mendukung `480p` dan `720p` 4. **Urutan Referensi**: susun `images`, `videos`, dan `audios` sesuai tujuan dan rujuk secara konsisten dalam prompt 5. **Permintaan Hanya Video**: gunakan array `images` kosong hanya jika setidaknya satu video referensi disediakan 6. **Durasi Media**: pastikan setiap audio dan video referensi berdurasi antara 2 dan 15 detik 7. **Pemanfaatan Audio**: hilangkan `sound` untuk memakai nilai bawaan `true`, atau atur ke `false` untuk menonaktifkan suara yang dihasilkan