Seedance 1.5 Pro API

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Seedance 1.5 Pro.

Các 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 1.5 Pro 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-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Ví dụ chỉ body với các tham số tùy chọn:

javascriptSao chép
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}

Seedance 1.5 Pro 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-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Ví dụ chỉ body:

javascriptSao chép
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}

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

Phản Hồi Ban Đầu

Cả hai mô hình đều 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

Gọi 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: Đ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: 2-5 phút tùy thuộc vào thời lượng và độ phân giải.

Các video dài hơn ở độ phân giải 1080p có thể mất tới 8 phút. Thực hiện polling mỗi 5-10 giây để kiểm tra trạng thái.

Các Phương Pháp Tốt Nhất

1. Mô tả chuyển động rõ ràng: Bao gồm các mô tả chuyển động cụ thể trong prompt để có kết quả dự đoán được hơn
2. Lựa chọn độ phân giải: Sử dụng 480p hoặc 720p để lặp nhanh hơn, 1080p cho đầu ra cuối cùng
3. Kiểm soát máy quay: Đặt camera_fixed: true khi bạn muốn chủ thể là trọng tâm mà không có sự dịch chuyển máy quay
4. Tỷ lệ khung hình: Khớp tỷ lệ khung hình với nền tảng đích (ví dụ: 9:16 cho di động, 16:9 cho máy tính)
5. Khả năng tái tạo: Sử dụng tham số seed để tái tạo hoặc lặp lại trên một thế hệ cụ thể
6. Chất lượng ảnh: Đối với image-to-video, sử dụng ảnh đầu vào có độ phân giải cao, ánh sáng tốt để có kết quả tốt nhất