Seedance 2.0 Mini API

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

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

API này hỗ trợ ba 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 Mini Text to Video

Điểm Cuối

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

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

Tham Số Yêu Cầu

Bắt Buộc

Nội Dung Tham Chiếu

Mỗi yêu cầu phải chứa ít nhất một hình ảnh hoặc video. Gửi 1-9 hình ảnh khi dùng tham chiếu hình ảnh. Chỉ được bỏ qua hoặc để trống mảng images khi mảng videos chứa ít nhất một video tham chiếu. Không hỗ trợ yêu cầu chỉ có âm thanh.

Ký Hiệu Giữ Chỗ Tham Chiếu @ (AT)

Tính năng tham chiếu @ (AT) liên kết nội dung tham chiếu với câu lệnh qua các ký hiệu giữ chỗ có đánh số <<<...>>>. Mỗi loại nội dung được đánh số riêng từ 1, theo thứ tự của mảng tương ứng:

Mỗi ký hiệu giữ chỗ phải trỏ đến một phần tử tồn tại trong mảng tương ứng.

Tùy Chọn

Tính Phí Video Tham Chiếu

Seedance V2.0 Mini Reference-to-Video áp dụng cùng cơ chế tính phí theo giây dựa trên độ phân giải như các biến thể tham chiếu Seedance 2.0 khác. Khi mảng videos chứa ít nhất một video tham chiếu, tổng phí tạo video được nhân với 2. Hệ số này chỉ áp dụng một lần, không phụ thuộc số lượng hoặc thời lượng video tham chiếu đã tải lê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-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;

Giới Hạn Nội Dung Đa Phương Tiện

Các giới hạn này áp dụng cho hình ảnh khung hình đầu, hình ảnh khung hình cuối và nội dung tham chiếu của các mô hình trên trang này.

Âm thanh tham chiếu và video tham chiếu có giới hạn tổng thời lượng riêng là 15 giây cho mỗi loại. Số lượng cũng độc lập: tối đa 9 hình ảnh, 3 video và 3 đoạn âm thanh. Thêm video không làm giảm số hình ảnh được phép.

Tất cả mô hình mặc định dùng 720p, nhưng vẫn phải cung cấp resolution. Công tắc âm thanh mặc định là true; cả công tắc này lẫn âm thanh tham chiếu đều không thay đổi giá. Tạo video từ tham chiếu yêu cầu ít nhất một hình ảnh hoặc video; không hỗ trợ yêu cầu chỉ có âm thanh. Tải lên video tham chiếu làm phí tạo video tăng gấp đôi, bất kể số lượng hoặc thời lượng.

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

Phản Hồi Ban Đầu

Tất cả mô hình trả về task_id để truy vấn định kỳ:

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 Truy Vấn Định Kỳ

Truy vấn định kỳ 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": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Giá Trị Trạng Thái

• submitted: Tác vụ đã được tiếp nhận và đang chờ xử lý
• processing: Đang tạo video
• succeed: Đã tạo video xong
• failed: Tạo video thất bại

Thời Gian Xử Lý

Thời gian xử lý thông thường là 2-6 phút, tùy theo thời lượng và độ phân giải.

Truy vấn mỗi 5-10 giây để kiểm tra trạng thái.

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

1. Mô Tả Chuyển Động Rõ Ràng: Đưa mô tả chuyển động cụ thể vào câu lệnh
2. Chọn Độ Phân Giải: Dùng 480p để xử lý nhanh hơn, 720p để có chất lượng cao hơn
3. Tăng Cường Âm Thanh: Bật sound để trải nghiệm video sống động hơn
4. Hình Ảnh Thành Video: Cung cấp khung hình đầu rõ nét qua image_url; dùng image_end_url khi cần kiểm soát khung hình đầu và cuối
5. Nội Dung Tham Chiếu: Dùng hình ảnh, video và âm thanh tham chiếu được hỗ trợ, bảo đảm có ít nhất một hình ảnh hoặc video
6. Tính Phí Video Tham Chiếu: Mọi yêu cầu tạo video từ tham chiếu chứa ít nhất một video tham chiếu đều bị tính phí gấp 2 lần, bất kể số lượng hoặc thời lượng video đã tải lên
7. Tham Số Hạt Giống: Không gửi seed; các mô hình Seedance 2.0 Mini không hỗ trợ tham số này