Seedance 2.5 Flash API
Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Seedance 2.5 Flash của ByteDance.
Các biến thể mô hình
API này hỗ trợ ba biến thể mô hình sau.
So sánh nhanh
Tỷ lệ khung hình được hỗ trợ
Tạo video từ văn bản và từ tư liệu tham chiếu hỗ trợ các tỷ lệ sau.
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Mô hình tạo video từ hình ảnh không hỗ trợ tham số aspect_ratio.
Tùy chọn độ phân giải
Seedance 2.5 Flash Text to 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.5 Flash Image to Video
Tham số yêu cầu
Bắt buộc
Không bắt buộc
Khi yêu cầu tạo video từ hình ảnh, hãy bỏ qua
aspect_ratiovì mô hình này không hỗ trợ tham số đó.
Ví dụ yêu cầu
javascript
Seedance 2.5 Flash Reference to Video
Tham số yêu cầu
Bắt buộc
Tư liệu tham chiếu
Mọi tư liệu tham chiếu đều không bắt buộc. Yêu cầu có thể chỉ dùng ảnh, chỉ dùng video, chỉ dùng âm thanh hoặc không dùng tư liệu tham chiếu. Khi không dùng tư liệu tham chiếu, nên chọn mô hình tạo video từ văn bản.
Ký hiệu giữ chỗ cho tham chiếu @ (AT)
Tính năng tham chiếu @ (AT) liên kết tư liệu với câu lệnh bằng các ký hiệu giữ chỗ <<<...>>> có đánh số. Mỗi loại tư liệu được đánh số riêng từ 1 theo thứ tự trong mảng tương ứng.
Ví dụ, nếu ảnh đầu dùng để tham chiếu nhân vật và ảnh thứ hai dùng để 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ử có 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 tạo video từ tư liệu tham chiếu bằng @ (AT)
javascript
Giới hạn tư liệu
Các giới hạn sau á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 mỗi loại. Số lượng cũng được tính riêng, tối đa 10 ảnh, 5 video và 5 đoạn âm thanh.
Mọi mô hình đều yêu cầu resolution và duration và không có giá trị mặc định cho hai tham số này. Khi bỏ qua aspect_ratio, mô hình tạo video từ văn bản và từ tư liệu tham chiếu dùng tỷ lệ mặc định 16:9. Tùy chọn âm thanh mặc định là true. Đặt thành false để tạo video không có tiếng.
Định dạng phản hồi
Phản hồi ban đầu
Mọi mô hình đều trả về task_id để truy vấn trạng thái định kỳ.
json
Phản hồi khi truy vấn trạng thái
Gọi GET /api/v1/video/{taskId} định kỳ để kiểm tra trạng thái.
json
Giá trị trạng thái
submitted: Đã tiếp nhận tác vụ và đang chờ xử lýprocessing: Đang tạo videosucceed: Đã tạo video xongfailed: Tạo video thất bại
Thời gian xử lý
Thời gian xử lý phụ thuộc vào thời lượng, độ phân giải và tình trạng hàng đợi hiện tại.
Truy vấn lại sau mỗi 5–10 giây để kiểm tra trạng thái.
Khuyến nghị sử dụng
- Tham số bắt buộc: Luôn cung cấp
prompt,resolutionvàduration. Khi tạo video từ văn bản hoặc từ tư liệu tham chiếu,aspect_ratiolà tùy chọn và mặc định là16:9 - Tỷ lệ khi tạo video từ ảnh: Không gửi
aspect_ratiotrong yêu cầu tạo video từ hình ảnh - Video tham chiếu: Video không bắt buộc. Thời lượng của từng video và tổng thời lượng phải nằm trong giới hạn đã nêu
- Ảnh tham chiếu: Ảnh không bắt buộc, bất kể có video hay âm thanh hay không. Có thể gửi tối đa 10 URL ảnh thuộc định dạng hỗ trợ
- Âm thanh tham chiếu: Mỗi đoạn phải dài 2–30 giây và không quá 15 MB, với tổng thời lượng không quá 30 giây
- Thứ tự tham chiếu: Sắp xếp các phần tử trong
images,videosvàaudiostheo thứ tự mong muốn rồi tham chiếu nhất quán trong câu lệnh - Âm thanh: Bỏ qua
soundđể dùng giá trị mặc địnhtrue, hoặc đặt thànhfalseđể tắt tính năng tạo âm thanh