Tạo video(Seedance)
Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết Định dạng tương thích với Sora tạo video).
Được dùng để tạo tác vụ tạo video và truy vấn trạng thái cũng như kết quả thông qua ID tác vụ.
Các trường cốt lõi để tạo tác vụ:
model: Bắt buộc, tên mô hình.prompt: Bắt buộc, mô tả chính để tạo video.content: tùy chọn, mảng content của Volcano Ark, trộn văn bản, hình ảnh, video và âm thanh.function_mode: Tùy chọn, thường dùng cho các chế độ nâng cao như tham chiếu toàn năng.
Các tham số đầu vào tương thích:
mode:t2v / i2v / i2v_first_last / reference_images / reference_materialimage_url / image_urls / input_referenceend_image_url / last_image_urlvideo_urls / audio_urlsseconds / durationaspect_ratio / ratio / sizequality / resolutionfpsgenerate_audio / watermark
Chi tiết gọi API:
- Khi là
mode=reference_materialhoặcfunction_mode=omni_reference, nên truyền văn bản và tài liệu tham chiếu thông quacontent. contentmục văn bản được viết theo dạng{ "type": "text", "text": "测试文字" }.contentcác mục tài nguyên hình ảnh, video, âm thanh lần lượt dùng cú pháp đối tượngimage_url,video_url,audio_url, ví dụ{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }.rolecó thể dùng để xác định mục đích của tài nguyên,namecó thể được tham chiếu theo tên trong prompt.ratio,duration,resolution,fpssẽ ảnh hưởng đến cấu hình tạo cuối cùng.
Gọi Gemini Omni:
gemini-omnicũng có thể được gọi thông qua giao diện tác vụ Seedance này.mode=t2vdùng cho tạo video từ văn bản,mode=r2vdùng cho tạo bằng ảnh tham chiếu/tài nguyên tham chiếu,mode=editdùng cho chỉnh sửa video.- Văn bản có thể đặt trong mục
textcủaprompthoặccontent; hình ảnh có thể đặt trongimage_url / image_urls / reference_images / input_reference / content; video có thể đặt trongvideo_urls / content. - Trường thời lượng có thể dùng
durationhoặcseconds, hệ thống sẽ tự động khớp với các mức 4 / 6 / 8 / 10 giây.
Các trường cần lưu ý trong kết quả truy vấn:
items[].statusitems[].content.video_urlhoặcitems[].video_urlitems[].erroritems[].progress
Error fields: error.code, error.message.
{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}
Ủy quyền
Sử dụng xác thực Bearer Token.
Định dạng: Authorization: Bearer sk-xxxxxx
Nội dung
Bắt buộc. Tên mô hình. Có thể truyền mô hình bên ngoài Seedance, cũng có thể truyền gemini-omni.
doubao-seedance-1-0-lite-i2v-250428, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, gemini-omni "doubao-seedance-2-0-260128"
Bắt buộc. Mô tả chính để tạo video, không được để trống.
"参考素材生成一段剧情短视频"
Tùy chọn. Mảng content của Volcano Ark, sắp xếp xen kẽ theo thứ tự giữa văn bản và các mục nội dung. Mục văn bản dùng { "type": "text", "text": "..." }; các mục hình ảnh, video, âm thanh lần lượt dùng các đối tượng image_url, video_url, audio_url và đặt url bên trong, có thể kết hợp với role (như reference_image, reference_video, reference_audio) và name để văn bản tham chiếu.
Tùy chọn. Chế độ tính năng nâng cao, chẳng hạn như omni_reference dùng để tham khảo toàn diện.
Tùy chọn. Các trường ở chế độ tương thích, như t2v, i2v, i2v_first_last, reference_images, reference_material; gemini-omni hỗ trợ t2v, r2v, edit.
Tùy chọn. URL của một ảnh tham chiếu duy nhất.
Tùy chọn. Danh sách URL của nhiều ảnh tham chiếu.
Tùy chọn. Tương thích với các trường nhập liệu tham chiếu.
Tùy chọn. URL hình ảnh tham chiếu cho khung hình cuối.
Tùy chọn. Alias URL của hình ảnh tham chiếu khung hình cuối.
Tùy chọn. Danh sách URL video tham chiếu.
Tùy chọn. Danh sách URL âm thanh tham chiếu.
Tùy chọn. Thời lượng video, tính bằng giây; tương thích với duration.
Tùy chọn. Thời lượng video, tính bằng giây; tương thích với seconds.
Tùy chọn. Tỷ lệ khung hình, ví dụ: 16:9.
Tùy chọn. Biệt danh của tỷ lệ khung hình, ví dụ: 16:9.
Tùy chọn. Trường tương thích với độ phân giải hoặc kích thước.
Tùy chọn. Cấu hình chất lượng tạo.
Tùy chọn. Độ phân giải đầu ra.
Tùy chọn. Tốc độ khung hình.
Tùy chọn. Có tạo âm thanh hay không.
Tùy chọn. Có thêm hình mờ (watermark) hay không.
