Vidu Image Q2 · Tài liệu API
Tạo ảnh với Vidu Image Q2 từ văn bản hoặc ảnh tham chiếu. Kiểm tra tác vụ và tải kết quả.
Tạo một nhiệm vụ với POST /v1/wand/vidu-image/generation và truy vấn nó với GET /v1/wand/vidu-image/tasks/{task_id}. Gửi một khóa API APIMaster trong tiêu đề Authorization: Bearer với cả hai yêu cầu. Phần thân của yêu cầu POST dùng định dạng JSON.
| Trường | Kiểu | Mô tả |
|---|---|---|
model |
string | Bắt buộc. Sử dụng vidu-image-q2. |
prompt |
string | Bắt buộc. Tối đa 2,000 ký tự. Để tạo ảnh chỉ từ văn bản, bỏ qua ảnh tham chiếu (text-to-image). |
images |
string[] | Không bắt buộc. Tối đa bảy URL công khai hoặc URI dữ liệu ở định dạng PNG, JPEG/JPG hoặc WebP. Mỗi ảnh phải có ít nhất 128 × 128 pixel, tỷ lệ từ 1:4 đến 4:1 và dung lượng tối đa 50 MB. Phần thân yêu cầu có dung lượng tối đa 20 MB. |
aspect_ratio |
string | 16:9 theo mặc định. Các tùy chọn là 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2, và auto. Thiết lập auto theo hình ảnh tham chiếu đầu tiên. |
resolution |
string | 1080p theo mặc định. Hỗ trợ 2K và 4K. Giá trị phân biệt chữ hoa và chữ thường. |
seed |
integer | Bỏ qua trường hoặc đặt giá trị 0 để sử dụng seed ngẫu nhiên. |
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'
Dùng task_id trả về và cùng tài khoản để kiểm tra trạng thái mỗi 3–5 giây. Các trạng thái có thể là created, queueing, processing, success, và failed. Để thành công, tải xuống các tập tin dưới creations[].url trong vòng 12 giờ. Sử dụng request_id để theo dõi các thất bại như hình ảnh không hiệu quả, đánh giá nội dung, tín dụng không đủ, giới hạn tần suất yêu cầu, hoặc nhiệm vụ thiếu.
Việc truy vấn trạng thái không tạo lại kết quả hoặc tính phí lần nữa. callback_url không được hỗ trợ. Để khôi phục lại một yêu cầu bị mất, gửi một yêu cầu ổn định Idempotency-Key của 8–128 nhìn thấy ASCII nhân vật và theo dõi Hướng dẫn khôi phục 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.
tokenhub_usage.total_tokens báo cáo việc sử dụng có tính phí, điều này phụ thuộc vào độ phân giải và số lượng tham chiếu đã được sử dụng. Xem Vidu Image Q2 thẻ mô hình Đối với hiện tại APIMaster Giá cả
