# Seedance 2.0 Mini API

Referensi API lengkap untuk model pembuatan video Seedance 2.0 Mini dari ByteDance.

## Varian Model

API ini mendukung tiga varian model:

| Model | ID | Deskripsi |
|-------|-----|-------------|
| **Seedance 2.0 Mini Text to Video** | `seedance-v2.0-mini-text-to-video` | Pembuatan video dari teks dengan biaya efisien |
| **Seedance 2.0 Mini Image to Video** | `seedance-v2.0-mini-image-to-video` | Animasi gambar hemat biaya dengan kontrol gerakan |
| **Seedance 2.0 Mini Reference to Video** | `seedance-v2.0-mini-reference-to-video` | Pembuatan video hemat biaya dengan panduan gambar, video, dan audio referensi |

## Perbandingan Singkat

| Fitur | Nilai |
|---------|-------|
| Rentang Durasi | 4-15 detik |
| Pilihan Resolusi | 480p, 720p |
| Pilihan Rasio Aspek | 21:9, 16:9, 9:16, 1:1, 4:3, 3:4 |
| Dukungan Audio | Ya (default: aktif) |
| Media Referensi | Gambar, video, dan audio untuk pembuatan video berbasis referensi |
| Kontrol Seed | Tidak didukung oleh model Seedance 2.0 Mini mana pun |

### 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 |

## Seedance 2.0 Mini Text to Video

### Titik Akhir

```
POST /api/v1/video/task
```

### Parameter Permintaan

#### Wajib

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `model_name` | string | Harus `"seedance-v2.0-mini-text-to-video"` |
| `prompt` | string | Prompt pembuatan video |
| `duration` | integer | Durasi video dalam detik bulat (4-15), dengan kelipatan 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"` |

#### Opsional

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `sound` | boolean | Apakah akan menghasilkan suara lingkungan (default: `true`) |

### 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-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Image to Video

### Parameter Permintaan

#### Wajib

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `model_name` | string | Harus `"seedance-v2.0-mini-image-to-video"` |
| `prompt` | string | Prompt pembuatan video |
| `duration` | integer | Durasi video dalam detik bulat (4-15), dengan kelipatan 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"` |
| `image_url` | string | Bingkai pertama video |

#### Opsional

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `image_end_url` | string | URL gambar bingkai akhir opsional |
| `sound` | boolean | Apakah akan menghasilkan suara lingkungan (default: `true`) |

### 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-mini-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',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Reference to Video

### Parameter Permintaan

#### Wajib

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `model_name` | string | Harus `"seedance-v2.0-mini-reference-to-video"` |
| `prompt` | string | Prompt pembuatan video. Tulis prompt biasa tanpa placeholder, atau gunakan fitur referensi @ (AT) dengan `<<<image_N>>>`, `<<<video_N>>>`, dan `<<<audio_N>>>` untuk merujuk item dalam array media terkait secara eksplisit |
| `duration` | integer | Durasi video dalam detik bulat (4-15), dengan kelipatan 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

Setiap permintaan harus menyertakan setidaknya satu gambar atau video. Kirim 1-9 gambar saat menggunakan referensi gambar. Array `images` hanya boleh dihilangkan atau dikosongkan jika array `videos` memuat setidaknya satu video referensi. Permintaan yang hanya berisi audio tidak didukung.

| 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 |

#### Placeholder Referensi @ (AT)

Fitur referensi @ (AT) menghubungkan media referensi dengan prompt melalui placeholder bernomor `<<<...>>>`. Penomoran dimulai dari `1` secara terpisah untuk setiap jenis media dan mengikuti urutan array terkait:

| Placeholder | Nilai yang Dirujuk |
|-------------|------------------|
| `<<<image_1>>>` | `images[0]` |
| `<<<image_2>>>` | `images[1]` |
| `<<<video_1>>>` | `videos[0]` |
| `<<<audio_1>>>` | `audios[0]` |

Setiap placeholder harus menunjuk ke item yang ada dalam array terkait.

#### Opsional

| Parameter | Tipe | Deskripsi |
|-----------|------|-------------|
| `sound` | boolean | Apakah akan menghasilkan suara tersinkronisasi. Default: `true` |

### Harga Video Referensi

Seedance V2.0 Mini Reference-to-Video mengikuti struktur penagihan per detik berdasarkan resolusi yang sama dengan varian referensi Seedance 2.0 lainnya. Jika array `videos` memuat setidaknya satu video referensi, total biaya pembuatan dikalikan 2. Pengali ini diterapkan satu kali, terlepas dari jumlah atau durasi video referensi yang diunggah.

### 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-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    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']
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Batas Media

Batas ini berlaku untuk gambar bingkai pertama, gambar bingkai terakhir, dan media referensi pada model di halaman ini.

| Media | Format | Batas |
|-------|---------|--------|
| Gambar | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Setiap gambar harus kurang dari 30 MB; lebar dan tinggi masing-masing harus 300-6000 px; rasio lebar terhadap tinggi harus 0,4-2,5 |
| Video | MP4, MOV | Maksimal 200 MB per video; lebar dan tinggi masing-masing harus 300-6000 px; rasio lebar terhadap tinggi harus 0,4-2,5; laju bingkai harus 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 15 detik yang terpisah. Jumlahnya juga dihitung secara independen: hingga 9 gambar, 3 video, dan 3 klip audio. Menambahkan video tidak mengurangi jumlah gambar yang diizinkan.

Semua model menggunakan `720p` secara default, tetapi `resolution` tetap wajib disertakan. Pengaturan suara bernilai `true` secara default; pengaturan ini maupun audio referensi tidak mengubah harga. Pembuatan video berbasis referensi memerlukan setidaknya satu gambar atau video; permintaan audio saja tidak didukung. Mengunggah video referensi menggandakan biaya pembuatan, terlepas dari jumlah atau durasinya.

## Format Respons

### Respons Awal

Semua model mengembalikan `task_id` untuk polling:

```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 Polling

Lakukan polling pada `GET /api/v1/video/{taskId}` 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 pemrosesan
- `processing`: Pembuatan video sedang berlangsung
- `succeed`: Pembuatan video selesai
- `failed`: Pembuatan video gagal

## Waktu Pemrosesan

Waktu pemrosesan umumnya 2-6 menit, bergantung pada durasi dan resolusi.

Lakukan polling setiap 5-10 detik untuk memeriksa status.

## Praktik Terbaik

1. **Jelaskan Gerakan dengan Jelas**: Sertakan deskripsi gerakan yang spesifik dalam prompt
2. **Pemilihan Resolusi**: Gunakan `480p` untuk pemrosesan lebih cepat dan `720p` untuk kualitas lebih tinggi
3. **Peningkatan Audio**: Aktifkan `sound` untuk pengalaman video yang lebih imersif
4. **Gambar ke Video**: Berikan bingkai pertama yang jelas melalui `image_url`; gunakan `image_end_url` saat perlu mengontrol bingkai awal dan akhir
5. **Media Referensi**: Gunakan gambar, video, dan audio referensi yang didukung, serta pastikan setidaknya satu gambar atau video disertakan
6. **Harga Video Referensi**: Setiap permintaan pembuatan video berbasis referensi yang memuat setidaknya satu video referensi dikenai biaya 2x, terlepas dari jumlah atau durasi video yang diunggah
7. **Parameter Seed**: Jangan kirim `seed`; model Seedance 2.0 Mini tidak mendukungnya