Tạo tác vụ ảnh thành video
- Tài liệu chính thức: https://platform.vidu.cn/docs/image-to-video
- Tạo tác vụ ảnh thành video và trả về task_id hoặc chi tiết tác vụ
- Điều khiển hành vi tạo bằng tham số yêu cầu
Authorizations
Request Body
Lời nhắc văn bản
Mô tả văn bản để tạo video.
Lưu ý: Không quá 2000 ký tự
Tên mô hình
Giá trị cho phép: viduq2, viduq1, viduq3-turbo, viduq3-pro
- viduq3-turbo: Tạo nhanh hơn viduq3-pro
- viduq3-pro: Âm thanh-video chất lượng cao; hình ảnh sống động, có chiều sâu hơn
- viduq2: Mô hình mới nhất
- viduq1: Hình ảnh rõ, chuyển cảnh mượt, chuyển động camera ổn định
Thời lượng video; mặc định tùy mô hình:
- viduq3-pro, viduq3-turbo: mặc định 5 giây, phạm vi 1–16
- viduq2: mặc định 5 giây, phạm vi 1–10
- viduq1: mặc định 5 giây, chỉ 5
Hạt giống ngẫu nhiên
Nếu bỏ qua hoặc 0, dùng giá trị ngẫu nhiên
Nếu đặt thủ công, dùng hạt đã đặt
Độ phân giải; mặc định tùy mô hình và thời lượng:
- viduq3-pro, viduq3-turbo (1–16 giây): mặc định 720p, cho phép 540p, 720p, 1080p
- viduq2 (1–10 giây): mặc định 720p, cho phép 540p, 720p, 1080p
- viduq1 (5 giây): mặc định 1080p, cho phép 1080p
Biên độ chuyển động
Mặc định auto; cho phép: auto, small, medium, large
Lưu ý: Không có hiệu lực khi dùng mô hình q2
Tham số truyền xuyên suốt
Không xử lý; chỉ truyền dữ liệu
Lưu ý: Tối đa 1048576 ký tự
Chế độ ngoài giờ cao điểm; mặc định false; cho phép:
- true: tạo video ở chế độ ngoài giờ cao điểm
- false: tạo video ngay lập tức
Lưu ý 1: Chế độ ngoài giờ cao điểm tiêu thụ ít tín dụng hơn; xem bảng giá
Lưu ý 2: Tác vụ ngoài giờ cao điểm được xử lý trong 48 giờ; tác vụ chưa hoàn thành sẽ bị hủy và hoàn tín dụng
Lưu ý 3: Có thể hủy thủ công tác vụ ngoài giờ cao điểm
Có thêm watermark không
- true: thêm watermark
- false: không thêm
Lưu ý 1: Nội dung watermark cố định (do AI tạo); mặc định tắt
Lưu ý 2: Video có watermark qua watermarked_url trong API truy vấn tác vụ
Vị trí watermark trên ảnh:
1: trên-trái
2: trên-phải
3: dưới-phải
4: dưới-trái
Mặc định: 3
URL ảnh watermark
Nếu bỏ qua, văn bản mặc định: Nội dung do AI tạo
Định danh metadata (chuỗi JSON), truyền xuyên; định dạng tùy chỉnh hoặc ví dụ:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
Nếu trống, mặc định dùng metadata do Vidu tạo
URL callback (POST). Đặt khi tạo tác vụ; Vidu gửi cập nhật trạng thái. Nội dung giống phản hồi API truy vấn tác vụ.
Giá trị status callback:
- processing: đang xử lý
- success: hoàn thành (thử lại tối đa 3 lần nếu gửi thất bại)
- failed: thất bại (thử lại tối đa 3 lần nếu gửi thất bại)
Vidu dùng xác thực chữ ký callback; xem tài liệu chữ ký callback
Ảnh khung đầu
Mô hình dùng ảnh trong tham số này làm khung đầu để tạo video.
Lưu ý 1: Hỗ trợ Base64 ảnh hoặc URL ảnh (phải truy cập được)
Lưu ý 2: Chỉ 1 ảnh
Lưu ý 3: Định dạng: png, jpeg, jpg, webp
Lưu ý 4: Tỷ lệ khung hình nhỏ hơn 1:4 hoặc 4:1
Lưu ý 5: Kích thước ảnh tối đa 50 MB
Lưu ý 6: Thân POST HTTP không quá 20 MB; phải có Content-Type phù hợp, ví dụ:
data:image/png;base64,{base64_encode}
Có dùng đầu ra âm thanh-video trực tiếp không; mặc định false; cho phép:
- false: không đầu ra trực tiếp (video im lặng)
- true: video có thoại và âm nền
Lưu ý 1: voice_id chỉ có hiệu lực khi tham số này là true
Lưu ý 2: Khi model là q3-pro hoặc q3-turbo, mặc định là true
Lưu ý 3: Không hỗ trợ chế độ ngoài giờ cao điểm khi tham số này là true
ID giọng nói
Quyết định âm sắc trong video; nếu trống, hệ thống gợi ý. Danh sách: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
Có dùng lời nhắc được đề xuất không
- true: hệ thống đề xuất lời nhắc (số lượng=1) và tạo video theo đó
- false: tạo theo prompt đầu vào
Lưu ý: Lời nhắc đề xuất thêm 10 tín dụng mỗi tác vụ
Responses
Thành công