Seedance 2.0 API
Tài liệu tham chiếu API đầy đủ cho các mô hình tạo video Seedance 2.0 của ByteDance.
Các biến thể mô hình
API này hỗ trợ sáu 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 Văn bản thành video
Điểm cuối
POST /api/v1/video/task
Tham số yêu cầu
Bắt buộc
Không bắt buộc
Ví dụ yêu cầu
javascript
Seedance 2.0 Ảnh thành video
Tham số yêu cầu
Bắt buộc
Không bắt buộc
Ví dụ yêu cầu
javascript
Seedance 2.0 Tham chiếu thành video
Tham số yêu cầu
Bắt buộc
Nội dung tham chiếu
Gửi 1-9 ảnh. Chỉ được bỏ ảnh khi cung cấp ít nhất một video tham chiếu.
Ký hiệu giữ chỗ tham chiếu @ (AT)
Tính năng tham chiếu @ (AT) liên kết nội dung tham chiếu với câu lệnh thông qua các ký hiệu <<<...>>> được đánh số. Mỗi loại nội dung được đánh số riêng từ 1 theo thứ tự của 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 phải trỏ đến một phần tử thực sự tồn tại trong mảng tương ứng.
Không bắt buộc
Ví dụ yêu cầu
javascript
Ví dụ yêu cầu Tham chiếu thành video với @ (AT)
javascript
Các biến thể Fast
Các biến thể Fast ưu tiên tốc độ xử lý. Tất cả mô hình Fast chỉ hỗ trợ đầu ra "480p" và "720p". Các phần khác trong cấu trúc yêu cầu Fast Văn bản thành video và Fast Ảnh thành video giống mô hình tiêu chuẩn tương ứng, còn Fast Tham chiếu thành video dùng cùng giới hạn nội dung tham chiếu với mô hình tham chiếu tiêu chuẩn.
Ví dụ yêu cầu Fast
javascript
Ví dụ yêu cầu Fast Tham chiếu thành video với @ (AT)
javascript
Tham số Seedance 2.0 Fast Tham chiếu thành video
Bắt buộc
Nội dung tham chiếu
Quy tắc đánh số ký hiệu giữ chỗ từ 1 ở trên cũng áp dụng cho mô hình Fast Tham chiếu thành video.
Không bắt buộc
Giới hạn nội dung
Các giới hạn này áp dụng cho ảnh khung hình đầu, ảnh khung hình cuối và nội dung tham chiếu của các mô hình trên trang này.
Âm thanh và video tham chiếu mỗi loại có giới hạn tổng thời lượng riêng là 15 giây. Số lượng độc lập: tối đa 9 ảnh, 3 video và 3 đ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. Công tắc âm thanh mặc định là true; cả công tắc này lẫn âm thanh tham chiếu đều không thay đổi giá. Tham chiếu thành video cần ít nhất một ảnh hoặc video; không hỗ trợ yêu cầu chỉ có âm thanh. Tải video tham chiếu lên sẽ tăng gấp đôi phí tạo, bất kể số lượng hay thời lượng.
Đị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ỳ:
json
Phản hồi truy vấn định kỳ
Truy vấn GET /api/v1/video/{taskId} để kiểm tra trạng thái:
json
Giá trị trạng thái
submitted: đã nhận tác vụ và đang chờ xử lýprocessing: đang tạo videosucceed: đã tạo video thành côngfailed: tạo video thất bại
Thời gian xử lý
Mô hình tiêu chuẩn: 3-8 phút tùy thời lượng và độ phân giải.
Mô hình Fast: 1-4 phút với hầu hết cấu hình.
Kiểm tra trạng thái mỗi 5-10 giây.
Thực hành tốt nhất
- Chọn biến thể phù hợp: dùng mô hình Fast để thử nghiệm và mô hình tiêu chuẩn cho đầu ra cuối cùng
- Mô tả rõ chuyển động: đưa mô tả chuyển động cụ thể vào câu lệnh
- Chọn độ phân giải: tất cả mô hình Seedance 2.0 tiêu chuẩn hỗ trợ
480p,720p,1080pvà4k; tất cả mô hình Fast chỉ hỗ trợ480pvà720p - Thứ tự tham chiếu: sắp xếp
images,videosvàaudioscó chủ đích và tham chiếu nhất quán trong câu lệnh - Yêu cầu chỉ có video: chỉ dùng mảng
imagesrỗng khi cung cấp ít nhất một video tham chiếu - Thời lượng nội dung: giữ mỗi đoạn âm thanh và video tham chiếu dài từ 2 đến 15 giây
- Sử dụng âm thanh: bỏ
soundđể dùng giá trị mặc địnhtrue, hoặc đặt thànhfalseđể tắt âm thanh được tạo