Ra lệnh bằng AI.
VeoBulk chạy tại máy bạn.
MCP kết nối Codex, Claude Desktop hoặc Cursor với VeoBulk Desktop để xếp hàng tạo ảnh và video trên Google Flow. Không có cookie, mật khẩu hay bearer Google nào được gửi cho AI.
Option dùng chung khi tạo
AI nên gọi veobulk_capabilities trước để lấy đúng model, tỉ lệ, thời lượng, giới hạn và mặc định theo phiên bản Desktop. Sáu tool tạo đều hỗ trợ remove_logo: đặt true để xóa logo/watermark khi Desktop lưu file, false để giữ nguyên, hoặc bỏ trống để dùng cấu hình hiện tại trong Desktop.
Desktop phải đang mở
Đăng nhập VeoBulk và ít nhất một tài khoản Google Flow trước khi AI gọi tool.
Chỉ chạy local
Gateway chỉ nghe tại 127.0.0.1, dùng secret ngẫu nhiên và không mở cổng Internet.
Kiểm tra MAX mỗi lần
Free và Pro nhận lỗi MAX_PLAN_REQUIRED; sửa file local không mở khóa được.
Cài đặt trong 3 bước
Cập nhật VeoBulk Desktop
Cài bản Desktop mới nhất, mở ứng dụng và đăng nhập tài khoản VeoBulk có gói MAX.
Đăng nhập Google Flow
Trong Desktop, thêm hoặc đăng nhập lại tài khoản Google Flow. MCP sử dụng chính profile và credit Google này.
Thêm cấu hình MCP vào AI client
Mở phần MCP Servers của Codex, Claude Desktop hoặc Cursor và thêm cấu hình sau. Thay TEN_BAN bằng tên Windows thực tế; nếu cài ở thư mục khác, chọn đúng file resources\\mcp\\veobulk-mcp.cmd.
Windows
{
"mcpServers": {
"veobulk": {
"command": "C:\\Users\\TEN_BAN\\AppData\\Local\\Programs\\VeoBulk.com\\resources\\mcp\\veobulk-mcp.cmd"
}
}
}macOS
{
"mcpServers": {
"veobulk": {
"command": "/Applications/VeoBulk.com.app/Contents/Resources/mcp/veobulk-mcp.sh"
}
}
}Schema của 6 luồng tạo
Text to Image
prompt hoặc prompts (tối đa 500), model, tỉ lệ 16:9/4:3/1:1/3:4/9:16, count 1–4, concurrency 1–20. Tất cả đều nhận remove_logo.
Ảnh Đồng Nhất
1–10 ảnh {base64, mimeType}, đúng 1 prompt, model ảnh, tỉ lệ. Tất cả đều nhận remove_logo.
Text to Video
prompt hoặc prompts, model, tỉ lệ 16:9/9:16, duration 6s/8s, count 1–4, concurrency 1–10. Tất cả đều nhận remove_logo.
Image → Video
1 ảnh {base64, mimeType}, đúng 1 motion prompt, model, tỉ lệ, duration 6s/8s. Tất cả đều nhận remove_logo.
Video Đồng Nhất
1–7 ảnh {base64, mimeType}, đúng 1 prompt, model tương thích, tỉ lệ, duration. Tất cả đều nhận remove_logo.
Video Từ Frames
frame đầu và frame cuối {base64, mimeType}, đúng 1 motion prompt, model, tỉ lệ, duration. Tất cả đều nhận remove_logo.
Batch và 8 luồng
Google nhận tối đa 4 ảnh/request. Chọn concurrency 8 nghĩa là 2 request × 4 ảnh trong mỗi wave; 200 ảnh tương ứng khoảng 25 wave. Ảnh dùng request 4 ảnh nên giá trị lẻ như 6 sẽ làm tròn xuống 4; chọn 8 nếu cần đủ 8. Một job tối đa 500 prompt và 1.000 kết quả. Kết quả được sắp lại đúng thứ tự prompt dù request hoàn thành khác thứ tự.
{
"prompts": ["một con mèo trắng", "một con bò trên đồng cỏ"],
"model": "NARWHAL",
"aspect": "9:16",
"count": 1,
"concurrency": 8,
"remove_logo": true
}Model, media và kết quả
GEM_PIX_2 là Nano Banana Pro; NARWHAL là Nano Banana 2. Ảnh đầu vào phải là base64 thuần với MIME image/jpeg, image/png...; không gửi URL tùy ý. Request local tối đa 32 MB. Lưu ID job rồi dùng veobulk_get_job; Desktop hiển thị prompt, wave, tiến độ, ETA, thumbnail và kết quả ngay tại trang tạo tương ứng.
Xử lý lỗi an toàn
Các mã thường gặp: MAX_PLAN_REQUIRED, AUTH_REQUIRED, FLOW_LOGIN_REQUIRED, DESKTOP_NOT_RUNNING, INVALID_PARAMS, PROMPT_LIMIT_EXCEEDED và OUTPUT_LIMIT_EXCEEDED. Job đang chạy khi Desktop restart được đánh dấu lỗi và không tự retry để tránh trừ credit hai lần. Khi Google trả reCAPTCHA/429, giảm concurrency và chờ trước khi chạy lại.
Tool AI có thể gọi
veobulk_capabilitiesĐọc schema, option, enum, mặc định và giới hạn trước khi gọi
veobulk_statusKiểm tra Desktop và quyền MAX
veobulk_list_accountsXem các tài khoản Google Flow đã đăng nhập
veobulk_create_imagesTạo một hoặc nhiều ảnh từ prompt
veobulk_create_videosTạo video text-to-video
veobulk_create_consistent_imagesTạo ảnh đồng nhất từ tối đa 10 ảnh tham chiếu
veobulk_create_image_to_videoTạo video từ một ảnh nguồn và motion prompt
veobulk_create_consistent_videoTạo video đồng nhất từ 1–7 ảnh tham chiếu
veobulk_create_frames_videoTạo video từ frame đầu và frame cuối
veobulk_get_jobTheo dõi tiến độ và lấy kết quả
veobulk_list_jobsXem các job trong phiên Desktop hiện tại
veobulk_cancel_jobHủy job đang chờ hoặc đang chạy
Lưu ý quan trọng
- • MCP dùng credit của tài khoản Google Flow, không cung cấp thêm credit Google.
- • Job được chạy tuần tự để tránh tranh chấp profile và giảm lỗi reCAPTCHA/bot detection.
- • Đóng VeoBulk Desktop thì MCP sẽ báo
DESKTOP_NOT_RUNNING. - • Job gần nhất được lưu qua lần khởi động lại; job đang chạy bị ngắt sẽ được đánh dấu lỗi và không tự chạy lại để tránh trừ credit hai lần.