Dành riêng cho gói MAX

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

1

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.

2

Đă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.

3

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_EXCEEDEDOUTPUT_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_status

Kiểm tra Desktop và quyền MAX

veobulk_list_accounts

Xem các tài khoản Google Flow đã đăng nhập

veobulk_create_images

Tạo một hoặc nhiều ảnh từ prompt

veobulk_create_videos

Tạo video text-to-video

veobulk_create_consistent_images

Tạo ảnh đồng nhất từ tối đa 10 ảnh tham chiếu

veobulk_create_image_to_video

Tạo video từ một ảnh nguồn và motion prompt

veobulk_create_consistent_video

Tạo video đồng nhất từ 1–7 ảnh tham chiếu

veobulk_create_frames_video

Tạo video từ frame đầu và frame cuối

veobulk_get_job

Theo dõi tiến độ và lấy kết quả

veobulk_list_jobs

Xem các job trong phiên Desktop hiện tại

veobulk_cancel_job

Hủ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.
MCP local cho VeoBulk Desktop | VeoBulk