Vidu Video Q4 Preview · Tài liệu API
Tạo video từ một hình ảnh hoặc tham chiếu, sau đó kiểm tra nhiệm vụ APIMaster.
Sử dụng POST /v1/wand/vidu/image-to-video cho một hình ảnh khởi động hoặc POST /v1/wand/vidu/reference-to-video cho thế hệ hướng dẫn tham khảo. Tính năng của GET /v1/wand/vidu/tasks/{task_id} Sử dụng JSON để gửi và xác thực Bearer cho mỗi yêu cầu. Chỉ tạo văn bản và một điểm kết thúc start/end riêng biệt không có sẵn cho mô hình này.
| Trường | Kiểu | Mô tả |
|---|---|---|
model |
string | Bắt buộc. Sử dụng vidu-video-q4-preview. |
images |
string[] | Image-to-video đòi hỏi chính xác một hình ảnh. Reference-to-video chấp nhận hình ảnh 15 hoặc subjects. Sử dụng công khai URLs hoặc dữ liệu URI trong PNG, JPEG/JPG, hoặc WebP. Mối quan hệ nhìn phải là 1:4 đến 4:1. Mỗi hình ảnh URL có thể lên đến 50 MB. Base64 hình ảnh được giới hạn với 15 MB trước khi mã hóa và 20 MB mã hóa tổng thể. |
subjects |
object[] | Đối với reference-to-video như là một sự thay thế cho images. Cài đặt mỗi mục name và một đến ba images. Tham khảo một chủ đề với @name trong prompt. |
prompt |
string | Cần thiết cho reference-to-video. Tối đa 2,000 ký tự cho tham chiếu hình ảnh trực tiếp hoặc 5,000 cho các chủ đề và image-to-video. Image-to-video bỏ qua trường này khi is_rec đang chạy. |
auto_subjects |
boolean | Tùy chọn thư viện chủ đề cho reference-to-video. Mặc định là false. |
audio |
boolean | Chất lượng true cho image-to-video và false cho reference-to-video. Video tham khảo với âm thanh đòi hỏi subjects và giá trị true rõ ràng. |
audio_type |
string | Khi âm thanh được bật, hãy sử dụng all (đặc định), speech_only, hoặc sound_effect_only. |
is_rec |
boolean | Tự động khuyến nghị nhanh cho image-to-video. Tăng khả năng này làm tăng việc sử dụng. |
duration |
integer | Từ 3 đến 16 giây, với 5 như mặc định. |
resolution |
string | 540p, 720p (được mặc định), 1080p, 2K, hoặc 4K. |
aspect_ratio |
string | Reference-to-video chỉ có Sử dụng 16:9 (tiền định), 9:16, 3:4, 4:3, hoặc 1:1. Image-to-video theo dõi hình ảnh nhập. |
seed |
integer | Bỏ qua trường hoặc đặt giá trị 0 để sử dụng seed ngẫu nhiên. |
payload |
string | Dữ liệu ứng dụng tùy chọn, lên đến các ký tự 1,048,576. |
watermark |
boolean | Mặc định là false. |
wm_url |
string | Tùy chọn tùy chỉnh dấu nước URL. Chứng chỉ nước mặc định xuất hiện ở bên trái trên. API không chấp nhận wm_position. |
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'
Dùng task_id và cùng tài khoản để kiểm tra trạng thái mỗi 5–10 giây. Các quốc gia là created, queueing, processing, success, và failed. Trong thành công, creations[].url là video và creations[].cover_url là bìa của nó. Tải về các liên kết tạm thời trong thời gian 12. Giữ request_id khi báo cáo một thất bại.
Sử dụng một Idempotency-Key của 8–128 có thể nhìn thấy ASCII ký tự để khôi phục một yêu cầu. Cùng khóa và cùng tham số sẽ trả về biên nhận khôi phục với mã HTTP 202. Cùng khóa nhưng khác tham số sẽ trả về mã HTTP 409. Xem Hướng dẫn khôi phục yêu cầu. Query timeouts có thể được rút lại mà không tạo ra một video mới.
Cửa cổng đặt thế hệ một lần. tokenhub_usage.total_tokens báo cáo sử dụng có tính phí. Xem Vidu Video Q4 Preview thẻ mô hình Đối với hiện tại APIMaster Giá cả
