Tạo tác vụ văn bản thành video
- Tài liệu chính thức: https://platform.vidu.cn/docs/text-to-video
- Tạo tác vụ văn bản thành video và trả về task_id
- Điều khiển quá trình tạo bằng model, prompt và các tham số khác
Authorizations
Request Body
Gợi ý văn bản
Mô tả văn bản để tạo video.
Lưu ý: Không được vượt quá 2000 ký tự
Tên model
Giá trị cho phép: viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo: Tạo nhanh hơn so với viduq3-pro
- viduq3-pro: Tạo âm thanh-hình ảnh chất lượng cao hiệu quả; nội dung sống động, biểu cảm, có chiều sâu hơn
- viduq2: Model mới nhất
- viduq1: Hình ảnh rõ nét, chuyển cảnh mượt, chuyển động camera ổn định
Phong cách
Mặc định general; cho phép: general, anime
general: Phong cách chung; điều khiển qua prompt
anime: Phong cách anime; thể hiện anime nổi bật; điều khiển qua các prompt phong cách anime khác nhau
Lưu ý: Không có hiệu lực khi dùng model q2
Thời lượng video; mặc định phụ thuộc model:
- 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ỉ cho phép 5
Hạt giống ngẫu nhiên
Nếu bỏ qua hoặc là 0, hệ thống dùng giá trị ngẫu nhiên
Nếu đặt thủ công, dùng hạt giống đã đặt
Tỷ lệ khung hình
Mặc định 16:9; cho phép: 16:9, 9:16, 3:4, 4:3, 1:1
Lưu ý: 3:4 và 4:3 chỉ hỗ trợ trên model q2
Độ phân giải; mặc định phụ thuộc model 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 model q2
Có thêm nhạc nền cho video được tạo hay không.
Mặc định false; cho phép true, false
Nếu true, hệ thống chọn nhạc phù hợp từ thư viện BGM có sẵn.
- Độ dài BGM không giới hạn; tự điều chỉnh theo thời lượng video
Tham số truyền qua
Không xử lý; chỉ truyền dữ liệu
Lưu ý: Tối đa 1048576 ký tự
Có thêm watermark hay không
- true: thêm watermark
- false: không thêm watermark
Lưu ý 1: Nội dung watermark cố định (do AI tạo); mặc định tắt
Lưu ý 2: Dùng watermarked_url từ API truy vấn tác vụ để lấy video có watermark
Vị trí watermark trên hình ảnh:
1: góc trên bên trái
2: góc trên bên phải
3: góc dưới bên phải
4: góc dưới bên trái
Mặc định: 3
URL hình ảnh watermark
Nếu bỏ qua, văn bản watermark mặc định: Nội dung do AI tạo
Định danh metadata (chuỗi JSON), truyền qua; đị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 tác vụ đến URL này. Nội dung body khớp phản hồi API truy vấn tác vụ.
Giá trị status trong 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
Responses
Thành công