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

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

Seedance 2.0 Mini Reference to Video

Tham số request

Bắt buộc

Phương tiện tham chiếu

Mỗi request phải bao gồm ít nhất một hình ảnh hoặc video. Gửi 1-9 hình ảnh khi dùng hình ảnh tham chiếu. Chỉ có thể 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ợ request chỉ có âm thanh.

Placeholder tham chiếu @ (AT)

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

Mỗi placeholder phải trỏ đến một mục tồn tại trong mảng tương ứng.

Tùy chọn

Định giá video tham chiếu

Seedance V2.0 Mini Reference-to-Video tuân theo cùng cấu trúc 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 được nhân với 2. Hệ số này chỉ được áp dụng một lần, bất kể số lượng hoặc thời lượng của các video tham chiếu đã tải lê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-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;

Đị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. Tăng cường âm thanh: Giữ sound bật để có trải nghiệm video nhập vai hơn
4. 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
5. Phương tiện tham chiếu: Dùng hình ảnh, video và âm thanh tham chiếu được hỗ trợ, đồng thời đảm bảo có ít nhất một hình ảnh hoặc video
6. Định giá video tham chiếu: Mọi request Reference-to-Video có í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ố Seed: Không gửi seed; các mô hình Seedance 2.0 Mini không hỗ trợ tham số này