API Seedance 2.0 Mini

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.

Biến thể mô hình

API này hỗ trợ hai 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ố request

Bắt buộc

Tùy chọn

Ví dụ request

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

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

Seedance 2.0 Mini Image to Video

Tham số request

Bắt buộc

Tùy chọn

Ví dụ request

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

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

Định dạng phản hồi

Phản hồi ban đầu

Tất 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"
        }
      ]
    }
  }
}

Giá trị trạng thái

• submitted: Tác vụ đã được chấp nhận và đang chờ xử lý
• processing: Đang tạo video
• succeed: Tạo video đã hoàn tất
• 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 thuộc vào thời lượng và độ phân giải.

Polling 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: Bao gồm mô tả chuyển động cụ thể trong prompt
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. Khả năng tái lập: Dùng tham số seed để tái tạo các lần tạo cụ thể
4. Tăng cường âm thanh: Giữ sound bật để có trải nghiệm video nhập vai hơn
5. Image to Video: Cung cấp khung hình đầu tiên rõ ràng qua image_url; dùng image_end_url khi bạn cần khung hình bắt đầu và kết thúc có kiểm soát