API Seedance 2.0 Mini

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

Varian Model

API ini mendukung tiga varian model:

Perbandingan Cepat

Rasio Aspek yang Didukung

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

Opsi 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 ke prompt melalui placeholder <<<...>>> bernomor. Penomoran dimulai dari 1 secara terpisah untuk setiap jenis media dan mengikuti urutan array yang sesuai:

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

Opsional

Harga Video Referensi

Seedance V2.0 Mini Reference-to-Video mengikuti struktur penagihan per detik berbasis resolusi yang sama dengan varian referensi Seedance 2.0 lainnya. Jika array videos memuat setidaknya satu video referensi, total biaya generasi 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;

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

Polling 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": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Nilai Status

• submitted: Tugas diterima dan menunggu untuk diproses
• processing: Generasi video sedang berlangsung
• succeed: Generasi video selesai
• failed: Generasi video gagal

Waktu Pemrosesan

Waktu pemrosesan umum adalah 2-6 menit tergantung durasi dan resolusi.

Polling setiap 5-10 detik untuk memeriksa status.

Praktik Terbaik

1. Jelaskan Gerakan dengan Jelas: Sertakan deskripsi gerakan spesifik dalam prompt
2. Pemilihan Resolusi: Gunakan 480p untuk pemrosesan lebih cepat, 720p untuk kualitas lebih tinggi
3. Peningkatan Audio: Biarkan sound aktif untuk pengalaman video yang lebih imersif
4. Image to Video: Sediakan frame pertama yang jelas melalui image_url; gunakan image_end_url saat Anda membutuhkan frame awal dan akhir yang terkontrol
5. Media Referensi: Gunakan referensi gambar, video, dan audio yang didukung, serta pastikan setidaknya satu gambar atau video disertakan
6. Harga Video Referensi: Setiap permintaan Reference-to-Video 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