Giới thiệu dự án
MiniMax H3 Cloud for Codex là một plugin tạo video sử dụng GPU đám mây. Plugin cho phép người dùng trực tiếp đưa ra yêu cầu trong Codex, sau đó tự động xử lý việc lựa chọn tài nguyên, tạo hoặc khởi động máy chủ, chuẩn bị ComfyUI Runtime, gửi workflow, tải MP4 và tắt máy chủ sau khi hoàn tất tác vụ.
Hiện plugin hỗ trợ nền tảng Youyun Zhishuan; README cho biết các nền tảng khác sẽ được bổ sung sau. Bản thân plugin miễn phí, nhưng GPU, ổ đĩa hệ thống, image và các tài nguyên đám mây khác sẽ do Youyun Zhishuan tính phí trực tiếp.
Lưu ý về giấy phép: Kho lưu trữ không bao gồm trọng số mô hình MiniMax H3. Mô hình chịu sự điều chỉnh của MiniMax H3 Community License Agreement, hiện nêu rõ việc loại trừ Liên minh châu Âu, Vương quốc Anh, Hàn Quốc và Hoa Kỳ cùng một số khu vực khác. Người dùng tại các khu vực bị loại trừ cần xin cấp phép riêng từ MiniMax trước, đồng thời xác nhận địa điểm, mục đích sử dụng và dịch vụ nền tảng phù hợp với các điều khoản liên quan.
Tính năng chính
Ba phương thức tạo video
- Tạo video từ văn bản: Tạo video dựa trên lời nhắc dạng văn bản.
- Tạo video từ khung hình chính: Có thể cung cấp khung hình đầu, khung hình cuối hoặc đồng thời cả hai.
- Tạo video từ hình ảnh tham chiếu: Hỗ trợ cung cấp từ 1 đến 9 hình ảnh tham chiếu.
Workflow đám mây tự động
Plugin hỗ trợ kiểm tra giá và tình trạng sẵn có của GPU. Sau khi người dùng xác nhận cấu hình, plugin sẽ xử lý các bước tiếp theo, bao gồm khởi động máy chủ tài nguyên, chuẩn bị ComfyUI Runtime, gửi workflow tạo video, tải kết quả và tắt máy chủ.
Bảo vệ chi phí và tắt máy chủ
Trước khi tạo tài nguyên tính phí, plugin phải nhận được xác nhận của người dùng. Theo mặc định, plugin thiết lập tự động tắt máy chủ dự phòng sau 30 phút và tắt máy chủ ngay sau khi tác vụ hoàn tất hoặc thất bại, nhằm giảm nguy cơ phát sinh thêm chi phí do máy chủ tiếp tục chạy.
Quản lý thông tin xác thực cục bộ
Plugin không yêu cầu người dùng gửi API Key vào cuộc trò chuyện Codex. Thông tin xác thực Youyun Zhishuan được CompShare CLI lưu ẩn trên máy cục bộ. Cấu hình plugin và video đã tạo cũng nằm ngoài thư mục cài đặt plugin, vì vậy việc nâng cấp plugin sẽ không ghi đè dữ liệu người dùng.
Chuẩn bị trước khi cài đặt
Trước khi bắt đầu cài đặt, hãy xác nhận môi trường cục bộ đáp ứng các điều kiện sau:
- Hệ điều hành là macOS hoặc Linux.
- Đã cài đặt Codex hỗ trợ tính năng plugin.
- Node.js phiên bản 20 trở lên.
- Có thể sử dụng
sshvàffprobetrên hệ thống. - Có tài khoản và API Key của Youyun Zhishuan.
- CompShare CLI phiên bản 0.3.5 trở lên.
Cài đặt CompShare CLI
Có thể cài đặt hoặc nâng cấp CompShare CLI thông qua PyPI, sau đó kiểm tra phiên bản:
python3 -m pip install --upgrade compshare-cli
compshare --versionXác nhận phiên bản hiển thị không thấp hơn 0.3.5. Có thể xem kho CompShare CLI trên GitHub để biết thêm thông tin.
Cài đặt plugin MiniMax H3 Cloud
Trước tiên, thêm kho dự án vào Codex Marketplace, sau đó cài đặt plugin tương ứng:
codex plugin marketplace add Sac-Y/MiniMax-H3-Cloud --ref main
codex plugin add minimax-h3-cloud@sac-y-minimax-h3Sau khi lệnh thực thi xong, bạn có thể gọi MiniMax H3 Cloud trong Codex. Trong lần chạy đầu tiên, plugin sẽ hướng dẫn hoàn tất việc thiết lập thông tin tài khoản, cấu hình GPU và tham số video.
Quy trình sử dụng lần đầu
- Đăng nhập nền tảng đám mây: Đăng ký hoặc đăng nhập Youyun Zhishuan, sau đó dùng CLI chính thức để lưu ẩn API Key trên máy cục bộ. Không dán API Key vào cuộc trò chuyện Codex.
- Chọn GPU: Xem giá theo thời gian thực và tình trạng sẵn có của GPU hiện tại, rồi chọn cấu hình phù hợp với nhu cầu và ngân sách.
- Cung cấp tham số tạo video: Gửi lời nhắc, cung cấp hình ảnh theo phương thức tạo video, đồng thời thiết lập tỷ lệ khung hình, thời lượng và độ phân giải.
- Xác nhận chi phí: Kiểm tra tham số video và chi phí dự kiến. Plugin chỉ tạo tài nguyên tính phí sau khi được xác nhận.
- Chờ tạo video: Plugin tự động chuẩn bị môi trường chạy, thực thi workflow và tải MP4.
- Xem kết quả: Sau khi tác vụ hoàn tất, bạn có thể phát video trong Codex và tải tệp MP4.
Ví dụ sử dụng cơ bản
Dưới đây là các ví dụ về yêu cầu có thể đưa ra trong Codex. Tùy chọn và cấu hình khả dụng cụ thể phải tuân theo hướng dẫn hiển thị trong lần chạy đầu tiên của plugin.
Ví dụ 1: Tạo video từ văn bản
Gọi MiniMax H3 Cloud để tạo một video về bờ biển lúc hoàng hôn. Máy quay di chuyển chậm về phía trước, sóng biển êm dịu, tổng thể mang tông màu ấm đậm chất điện ảnh. Hãy hướng dẫn tôi chọn tỷ lệ khung hình, thời lượng, độ phân giải và GPU.Plugin sẽ dựa trên yêu cầu để bắt đầu quy trình thu thập tham số và lựa chọn GPU, đồng thời hiển thị chi phí dự kiến trước khi tạo tài nguyên.
Ví dụ 2: Sử dụng khung hình đầu và cuối
Sử dụng MiniMax H3 Cloud để tạo video dựa trên khung hình đầu và khung hình cuối do tôi cung cấp. Hãy giữ cho chủ thể nhất quán và cho phép tôi xác nhận tham số video cùng chi phí dự kiến trước khi thực thi.Chế độ khung hình chính hỗ trợ chỉ cung cấp khung hình đầu, chỉ cung cấp khung hình cuối hoặc đồng thời cung cấp cả hai.
Ví dụ 3: Sử dụng nhiều hình ảnh tham chiếu
Gọi MiniMax H3 Cloud để tạo video bằng các hình ảnh tham chiếu do tôi cung cấp, đồng thời hướng dẫn tôi hoàn tất việc thiết lập tỷ lệ khung hình, thời lượng, độ phân giải và cấu hình tài nguyên.Chế độ tạo video từ hình ảnh tham chiếu hỗ trợ từ 1 đến 9 hình ảnh. Trước khi gửi, cần xác nhận số lượng hình ảnh nằm trong phạm vi được hỗ trợ.
Vị trí cấu hình và đầu ra
Theo mặc định, plugin ghi cấu hình vào:
~/.config/minimax-h3-cloud/config.jsonVideo được tạo theo mặc định lưu tại:
~/.local/share/minimax-h3-cloud/outputs/Cả hai thư mục đều nằm ngoài thư mục cài đặt plugin, vì vậy việc nâng cấp plugin sẽ không ghi đè cấu hình và video đã tạo. Khi cần sao lưu, bạn có thể sao chép riêng các tệp liên quan trong những thư mục này.
Sử dụng nâng cao và lưu ý
So sánh giá và tình trạng sẵn có theo thời gian thực
Giá và tình trạng sẵn có của GPU đám mây thay đổi theo thời gian thực. Trước khi bắt đầu tác vụ, nên lựa chọn cấu hình dựa trên ngân sách, tình trạng sẵn có và nhu cầu video. Nếu không có tài nguyên phù hợp, plugin sẽ quay lại bước lựa chọn GPU, thay vì âm thầm chuyển sang cấu hình chưa được người dùng xác nhận.
Kiểm tra kỹ thông tin xác nhận tính phí
Bản thân plugin không tính phí, nhưng nền tảng đám mây sẽ tính phí GPU, ổ đĩa hệ thống, image và các tài nguyên khác. Trước khi xác nhận tạo tài nguyên, cần kiểm tra GPU đã chọn, chi phí dự kiến và tham số video để tránh phát sinh chi phí không cần thiết do cấu hình sai.
Tận dụng cơ chế tắt máy chủ tự động để kiểm soát chi phí
Theo mặc định, plugin cung cấp cơ chế tắt máy chủ dự phòng sau 30 phút và tắt máy chủ ngay sau khi tác vụ hoàn tất hoặc thất bại. Dù vậy, người dùng vẫn nên theo dõi trạng thái tác vụ và trang tài nguyên của nền tảng đám mây để xác nhận máy chủ đã dừng đúng như dự kiến.
Không để lộ API Key trong cuộc trò chuyện
API Key cần được lưu trên máy cục bộ thông qua CompShare CLI, không được gửi vào cuộc trò chuyện Codex, nhật ký, ảnh chụp màn hình hoặc câu hỏi công khai. Quy trình bình thường của plugin sẽ không yêu cầu cung cấp thông tin xác thực trong nội dung trò chuyện.
Chọn phương thức tạo video theo loại đầu vào
- Chỉ có mô tả ý tưởng thì sử dụng tính năng tạo video từ văn bản.
- Cần kiểm soát cảnh mở đầu hoặc kết thúc thì sử dụng tính năng tạo video từ khung hình chính.
- Cần tham khảo nhiều tư liệu hình ảnh thì sử dụng tính năng tạo video từ hình ảnh tham chiếu và giới hạn số lượng hình ảnh ở mức từ 1 đến 9.
Kiểm tra giấy phép mô hình trước khi sử dụng
Mã nguồn plugin sử dụng MIT License, nhưng mô hình và workflow có các yêu cầu giấy phép riêng. Ngoài việc xem MiniMax H3 Community License Agreement, bạn cũng nên đọc thông tin giấy phép của bên thứ ba trong kho lưu trữ và xác nhận khu vực cùng mục đích sử dụng của mình phù hợp với các yêu cầu.
Câu hỏi thường gặp
Plugin có bao gồm trọng số mô hình MiniMax H3 không?
Không. README nêu rõ kho lưu trữ không cung cấp trọng số mô hình MiniMax H3.
Có thể sử dụng trên Windows không?
Môi trường được README liệt kê hỗ trợ là macOS hoặc Linux, chưa có tuyên bố hỗ trợ Windows.
Hiện plugin hỗ trợ những nền tảng đám mây nào?
Hiện tại plugin chỉ hỗ trợ Youyun Zhishuan; dự án dự kiến bổ sung các nền tảng khác trong tương lai.
Khi GPU hết hàng, plugin có tự động chuyển sang cấu hình khác không?
Không. Khi không tìm thấy tài nguyên phù hợp, plugin sẽ quay lại bước lựa chọn GPU và không tự ý chuyển sang cấu hình khác khi chưa được xác nhận.
Video được tạo lưu ở đâu?
Theo mặc định, video được lưu tại ~/.local/share/minimax-h3-cloud/outputs/.
Tóm tắt
MiniMax H3 Cloud for Codex tích hợp việc lựa chọn GPU đám mây, chuẩn bị ComfyUI Runtime, thực thi workflow video, tải MP4 và tắt máy chủ vào quy trình trò chuyện trong Codex. Sau khi hoàn tất cài đặt các dependency và cấu hình thông tin xác thực cục bộ, người dùng có thể tạo video từ văn bản, khung hình chính hoặc từ 1 đến 9 hình ảnh tham chiếu. Khi sử dụng thực tế, cần đặc biệt chú ý đến giấy phép mô hình, giá tài nguyên theo thời gian thực, xác nhận tính phí và bảo mật API Key.