API Seedance 2.5

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Seedance 2.5 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ợ

Text-to-Video và Reference-to-Video hỗ trợ:

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

Image-to-Video không hỗ trợ tham số aspect_ratio.

Tùy chọn độ phân giải

Seedance 2.5 Text to Video

Điểm cuối API

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Tùy chọn

Yêu cầu mẫ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.5-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    resolution: '720p',
    duration: 8,
    aspect_ratio: '16:9',
    sound: true
  })
});

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

Seedance 2.5 Image to Video

Tham số yêu cầu

Bắt buộc

Tùy chọn

Không đưa aspect_ratio vào yêu cầu Image-to-Video. Mô hình này không hỗ trợ tham số đó.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'seedance-v2.5-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  resolution: '720p',
  duration: 8,
  sound: true
}

Seedance 2.5 Reference to Video

Tham số yêu cầu

Bắt buộc

Phương tiện tham chiếu

Phần giữ chỗ 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 phần giữ chỗ <<<...>>> được đánh số. Việc đánh số bắt đầu từ 1 độc lập cho từng loại phương tiện 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 phần giữ chỗ phải trỏ đến một mục tồn tại trong mảng tương ứng.

Tùy chọn

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'seedance-v2.5-reference-to-video',
  prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere',
  resolution: '720p',
  duration: 8,
  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 với @ (AT)

javascriptSao chép
{
  model_name: 'seedance-v2.5-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>>>',
  resolution: '720p',
  duration: 10,
  aspect_ratio: '16:9',
  sound: true,
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.png'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

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

Phản hồi ban đầu

Tất cả mô hình đều trả về task_id để thăm dò:

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 thăm dò

Thăm dò 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 xong
• failed: Tạo video thất bại

Thời gian xử lý

Thời gian xử lý thay đổi tùy theo thời lượng, độ phân giải và tình trạng hàng đợi hiện tại.

Thăm dò mỗi 5-10 giây để kiểm tra trạng thái.

Các phương pháp hay nhất

1. Tham số bắt buộc: Luôn cung cấp resolution và duration, đồng thời cung cấp aspect_ratio cho Text-to-Video và Reference-to-Video
2. Tỷ lệ Image-to-Video: Không gửi aspect_ratio cho các yêu cầu Image-to-Video
3. Video tham chiếu: Reference-to-Video yêu cầu ít nhất một video; mỗi video và tổng thời lượng video phải nằm trong các giới hạn đã nêu trong tài liệu
4. Hình ảnh tham chiếu: Hình ảnh là tùy chọn khi đã cung cấp video tham chiếu; khi sử dụng, hãy gửi 1-30 URL hình ảnh được hỗ trợ
5. Âm thanh tham chiếu: Giữ mỗi đoạn âm thanh trong khoảng 2-30 giây và 15 MB, với tổng thời lượng không quá 30 giây
6. Thứ tự tham chiếu: Giữ images, videos và audios theo thứ tự chủ định và tham chiếu chúng nhất quán trong prompt
7. Âm thanh: Bỏ qua sound để dùng giá trị mặc định true, hoặc đặt thành false để tắt âm thanh được tạo