Seedance 2.5 API

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ợ

Văn bản thành video và Tham chiếu thành video hỗ trợ:

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

Hình ảnh thành 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

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.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 Hình ảnh thành video. Mô hình này không hỗ trợ tham số đó.

Ví dụ yêu cầ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

Tư liệu tham chiếu

Tất cả tư liệu tham chiếu đều là tùy chọn. Hỗ trợ yêu cầu chỉ có hình ảnh, chỉ có video, chỉ có âm thanh và không có tư liệu tham chiếu. Khi tạo không có tham chiếu, nên dùng Văn bản thành video.

Ký hiệu giữ chỗ tham chiếu @ (AT)

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

Ví dụ, nếu ảnh đầu tiên là tham chiếu nhân vật và ả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 ký hiệu giữ chỗ phải trỏ đến một phần tử thực sự tồn tại trong mảng tương ứng.

Tùy chọn

Ví dụ yêu cầ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 Tham chiếu thành 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']
}

Giới hạn tư liệu

Các giới hạn này áp dụng cho ảnh khung hình đầu, ảnh khung hình cuối và tư liệu 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à 30 giây cho từng loại. Số lượng cũng độc lập: tối đa 30 ảnh, 10 video và 10 đoạn âm thanh. Thêm video không làm giảm số ả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. Tùy chọn âm thanh mặc định là true; tùy chọn này và âm thanh tham chiếu đều không ảnh hưởng đến giá.

Đị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 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 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ý thay đổi theo thời lượng, độ phân giải và tình trạng hàng đợi hiện tạ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. Tham số bắt buộc: luôn cung cấp resolution và duration, đồng thời cung cấp aspect_ratio cho Văn bản thành video và Tham chiếu thành video
2. Tỷ lệ Hình ảnh thành video: không gửi aspect_ratio trong yêu cầu Hình ảnh thành video
3. Video tham chiếu: video là tùy chọn; thời lượng từng video và tổng thời lượng phải nằm trong giới hạn được nêu
4. Hình ảnh tham chiếu: hình ảnh là tùy chọn độc lập với video và âm thanh; gửi tối đa 30 URL ảnh thuộc định dạng được hỗ trợ
5. Âm thanh tham chiếu: mỗi đoạn phải dài 2-30 giây và không quá 15 MB, tổng thời lượng không quá 30 giây
6. Thứ tự tham chiếu: sắp xếp images, videos và audios theo thứ tự mong muốn và tham chiếu nhất quán trong câu lệnh
7. Âm thanh: bỏ qua sound để dùng mặc định true, hoặc đặt false để tắt tạo âm thanh