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:

Perbandingan Singkat

Rasio Aspek yang Didukung

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Pilihan Resolusi

Seedance 2.0 Mini Text to Video

Titik Akhir

POST /api/v1/video/task

Parameter Permintaan

Wajib

Opsional

Contoh Permintaan

javascriptSalin
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

Opsional

Contoh Permintaan

javascriptSalin
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

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.

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:

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

Opsional

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

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

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:

jsonSalin
{
  "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:

jsonSalin
{
  "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