Seedance 2.0 API

Tài liệu tham chiếu API đầy đủ cho các mô hình tạo video Seedance 2.0 của ByteDance.

Các Biến Thể Mô Hình

API này hỗ trợ sáu biến thể mô hình:

So Sánh Nhanh

Tỷ Lệ Khung Hình Được Hỗ Trợ

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

Tùy Chọn Độ Phân Giải

Seedance 2.0 Text to Video

Endpoint

POST /api/v1/video/task

Tham Số Yêu Cầu

Bắt buộc

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
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 Image to Video

Tham Số Yêu Cầu

Bắt buộc

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
{
  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 Reference to Video

Tham Số Yêu Cầu

Bắt buộc

Media Tham Chiếu

Gửi 1-9 hình ảnh. Chỉ có thể bỏ qua hình ảnh khi cung cấp ít nhất một video tham chiếu.

Placeholder Tham Chiếu @ (AT)

Tính năng tham chiếu @ (AT) liên kết media tham chiếu với prompt thông qua các placeholder <<<...>>> được đánh số. Số thứ tự bắt đầu từ 1 riêng cho từng loại media và tuân theo thứ tự của mảng tương ứng:

Ví dụ, nếu hình ảnh đầu tiên là tham chiếu nhân vật và hình ảnh thứ hai là tham chiếu bối cảnh, hãy dùng <<<image_1>>> cho nhân vật và <<<image_2>>> cho bối cảnh trong prompt. Mỗi placeholder phải trỏ đến một phần tử tồn tại trong mảng tương ứng.

Tùy chọn

Ví Dụ Yêu Cầu

javascriptSao chép
{
  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']
}

Ví Dụ Yêu Cầu Reference-to-Video @ (AT)

javascriptSao chép
{
  model_name: 'seedance-v2.0-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: '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']
}

Các Biến Thể Fast

Các biến thể Fast ưu tiên tốc độ xử lý. Tất cả mô hình Fast chỉ hỗ trợ đầu ra "480p" và "720p". Fast Text-to-Video và Fast Image-to-Video tuân theo cấu trúc yêu cầu tiêu chuẩn tương ứng ở các phần còn lại, còn Fast Reference-to-Video dùng cùng giới hạn media tham chiếu như mô hình tiêu chuẩn.

Ví Dụ Yêu Cầu Fast

javascriptSao chép
{
  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']
}

Ví Dụ Yêu Cầu Fast Reference-to-Video @ (AT)

javascriptSao chép
{
  model_name: 'seedance-v2.0-fast-reference-to-video',
  prompt: 'Have the dancer from <<<image_1>>> perform the movement from <<<video_1>>> on the stage in <<<image_2>>>, using the rhythm from <<<audio_1>>>',
  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']
}

Tham Số Seedance 2.0 Fast Reference-to-Video

Bắt buộc

Media Tham Chiếu

Quy ước placeholder đánh số từ 1 nêu trên cũng áp dụng cho mô hình Fast Reference-to-Video.

Tùy chọn

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

Tất cả các mô hình trả về task_id để polling:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Phản Hồi Polling

Polling GET /api/v1/video/{taskId} để kiểm tra trạng thái:

jsonSao chép
{
  "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"
        }
      ]
    }
  }
}

Các Giá Trị Trạng Thái

• submitted: Tác vụ đã được chấp nhận và đang chờ xử lý
• processing: Quá trình tạo video đang diễn ra
• succeed: Tạo video hoàn thành
• failed: Tạo video thất bại

Thời Gian Xử Lý

Mô hình Chuẩn: 3-8 phút tùy thuộc vào thời lượng và độ phân giải.

Mô hình Fast: 1-4 phút cho hầu hết các cấu hình.

Thực hiện polling mỗi 5-10 giây để kiểm tra trạng thái.

Thực Hành Tốt Nhất

1. Chọn Biến Thể Phù Hợp: Sử dụng mô hình fast để lặp thử, mô hình chuẩn cho đầu ra cuối cùng
2. Mô Tả Chuyển Động Rõ Ràng: Bao gồm mô tả chuyển động cụ thể trong lệnh
3. Lựa Chọn Độ Phân Giải: Sử dụng 480p để xử lý nhanh hơn và 720p cho chất lượng cao nhất hiện có
4. Kiểm Soát Máy Quay: Đặt camera_fixed: true khi muốn góc máy quay cố định
5. Hình Ảnh Tham Chiếu: Với reference-to-video, sử dụng hình ảnh tham chiếu rõ nét và chất lượng cao
6. Khả Năng Tái Tạo: Sử dụng tham số seed để tái tạo các kết quả cụ thể
7. Tăng Cường Âm Thanh: Bật sound để có trải nghiệm video sống động hơn