프로젝트 소개
MiniMax H3 Cloud for Codex는 클라우드 GPU로 구동되는 동영상 생성 플러그인입니다. 사용자는 Codex에서 직접 요구 사항을 입력할 수 있으며, 플러그인이 연산 자원 선택, 인스턴스 생성 또는 시작, ComfyUI Runtime 준비, 워크플로 제출, MP4 다운로드, 작업 종료 후 인스턴스 종료를 처리합니다.
플러그인은 현재 优云智算 플랫폼을 지원하며, README에 따르면 향후 다른 플랫폼도 추가될 예정입니다. 플러그인 자체는 무료지만, 사용하는 GPU, 시스템 디스크, 이미지 등의 클라우드 리소스 비용은 优云智算에서 직접 청구합니다.
라이선스 안내: 저장소에는 MiniMax H3 모델 가중치가 포함되어 있지 않습니다. 모델에는 MiniMax H3 Community License Agreement가 적용되며, 현재 계약상 유럽연합, 영국, 한국, 미국 등의 지역은 명시적으로 제외됩니다. 제외 지역에 있는 사용자는 먼저 MiniMax의 별도 승인을 받아야 하며, 사용 전에 자신의 소재지, 용도 및 플랫폼 서비스가 관련 약관을 준수하는지 확인해야 합니다.
핵심 기능
세 가지 동영상 생성 방식
- 텍스트-투-비디오: 텍스트 프롬프트를 기반으로 동영상을 생성합니다.
- 키프레임 기반 동영상 생성: 시작 프레임, 종료 프레임 또는 시작 프레임과 종료 프레임을 모두 제공할 수 있습니다.
- 참고 이미지 기반 동영상 생성: 1~9장의 참고 이미지를 제공할 수 있습니다.
자동화된 클라우드 워크플로
플러그인은 GPU 가격과 재고를 확인하고, 사용자가 구성을 확인한 후 연산 인스턴스 시작, ComfyUI Runtime 준비, 동영상 워크플로 제출, 결과 다운로드 및 인스턴스 종료를 포함한 후속 절차를 처리합니다.
비용 및 종료 보호
유료 리소스를 생성하기 전에 플러그인은 반드시 사용자의 확인을 받아야 합니다. 기본적으로 플러그인은 30분 후 안전 종료를 설정하며, 단일 작업이 완료되거나 실패하면 즉시 종료하여 인스턴스가 계속 실행되면서 추가 비용이 발생할 위험을 줄입니다.
로컬 자격 증명 관리
플러그인은 사용자가 API Key를 Codex 대화에 전송하도록 요구하지 않습니다. 优云智算 자격 증명은 CompShare CLI를 통해 로컬 컴퓨터에 숨겨 저장되며, 플러그인 설정과 생성된 동영상도 플러그인 설치 디렉터리 외부에 저장됩니다. 따라서 플러그인을 업그레이드해도 이러한 사용자 데이터가 덮어써지지 않습니다.
설치 전 준비
설치를 시작하기 전에 로컬 환경이 다음 조건을 충족하는지 확인하세요.
- 운영체제는 macOS 또는 Linux여야 합니다.
- 플러그인 기능을 지원하는 Codex가 설치되어 있어야 합니다.
- Node.js 버전은 20 이상이어야 합니다.
- 시스템에서
ssh와ffprobe를 사용할 수 있어야 합니다. - 优云智算 계정과 API Key가 있어야 합니다.
- CompShare CLI 버전은 0.3.5 이상이어야 합니다.
CompShare CLI 설치
PyPI를 통해 CompShare CLI를 설치하거나 업그레이드한 다음 버전을 확인할 수 있습니다.
python3 -m pip install --upgrade compshare-cli
compshare --version출력된 버전이 0.3.5 이상인지 확인하세요. CompShare CLI 프로젝트와 자세한 설명은 CompShare CLI GitHub 저장소에서 확인할 수 있습니다.
MiniMax H3 Cloud 플러그인 설치
먼저 프로젝트 저장소를 Codex Marketplace에 추가한 다음 해당 플러그인을 설치합니다.
codex plugin marketplace add Sac-Y/MiniMax-H3-Cloud --ref main
codex plugin add minimax-h3-cloud@sac-y-minimax-h3명령 실행이 완료되면 Codex에서 MiniMax H3 Cloud를 호출할 수 있습니다. 처음 실행할 때 플러그인이 안내에 따라 계정 자격 증명, GPU 구성 및 동영상 매개변수 설정을 진행합니다.
첫 사용 절차
- 클라우드 플랫폼 로그인: 优云智算에 가입하거나 로그인한 후 공식 CLI를 통해 API Key를 로컬 컴퓨터에 숨겨 저장합니다. API Key를 Codex 대화에 붙여넣지 마세요.
- GPU 선택: 현재 GPU의 실시간 가격과 재고를 확인하고 요구 사항과 예산에 맞는 구성을 선택합니다.
- 생성 매개변수 입력: 프롬프트를 제출하고 생성 방식에 따라 이미지를 제공하며, 화면 비율, 길이 및 해상도를 설정합니다.
- 비용 확인: 동영상 매개변수와 예상 비용을 확인합니다. 확인을 완료한 후에만 플러그인이 유료 리소스를 생성합니다.
- 생성 대기: 플러그인이 실행 환경을 자동으로 준비하고 워크플로를 실행한 뒤 MP4를 다운로드합니다.
- 결과 확인: 작업이 완료되면 Codex에서 동영상을 재생하고 MP4 파일을 다운로드할 수 있습니다.
기본 사용 예시
다음은 Codex에서 입력할 수 있는 요구 사항의 예시입니다. 구체적인 옵션과 사용 가능한 구성은 플러그인 최초 실행 시 표시되는 안내를 따라야 합니다.
예시 1: 텍스트-투-비디오
MiniMax H3 Cloud를 호출해 황혼의 해변을 담은 동영상을 생성해 주세요. 카메라는 천천히 앞으로 이동하고, 파도는 잔잔하며, 전체적으로 영화 같은 따뜻한 색감으로 표현해 주세요. 화면 비율, 길이, 해상도 및 GPU 선택을 안내해 주세요.플러그인은 요구 사항에 따라 매개변수 수집 및 GPU 선택 절차를 진행하고, 리소스를 생성하기 전에 예상 비용을 표시합니다.
예시 2: 시작 프레임과 종료 프레임 사용
제가 제공하는 시작 프레임과 종료 프레임을 사용해 MiniMax H3 Cloud로 동영상을 생성해 주세요. 주요 대상이 일관되게 유지되도록 하고, 실행 전에 동영상 매개변수와 예상 비용을 확인하게 해 주세요.키프레임 모드에서는 시작 프레임만, 종료 프레임만 또는 시작 프레임과 종료 프레임을 모두 제공할 수 있습니다.
예시 3: 여러 참고 이미지 사용
MiniMax H3 Cloud를 호출해 제가 제공하는 참고 이미지로 동영상을 생성하고, 화면 비율, 길이, 해상도 및 연산 자원 구성을 완료할 수 있도록 안내해 주세요.참고 이미지 기반 동영상 생성 모드는 1~9장의 참고 이미지를 지원합니다. 제출 전에 이미지 수가 지원 범위에 해당하는지 확인해야 합니다.
구성 및 출력 위치
플러그인은 기본적으로 다음 경로에 구성을 저장합니다.
~/.config/minimax-h3-cloud/config.json생성된 동영상은 기본적으로 다음 경로에 저장됩니다.
~/.local/share/minimax-h3-cloud/outputs/두 디렉터리 모두 플러그인 설치 디렉터리 외부에 있으므로 플러그인을 업그레이드해도 구성과 생성된 동영상이 덮어써지지 않습니다. 백업이 필요한 경우 이 디렉터리에서 관련 파일을 별도로 복사할 수 있습니다.
고급 사용 및 주의 사항
실시간 가격과 재고를 먼저 비교하세요
클라우드 GPU의 가격과 재고는 실시간으로 변동합니다. 작업을 시작하기 전에 예산, 재고 및 동영상 요구 사항을 함께 고려해 구성을 선택해야 합니다. 조건에 맞는 리소스가 없으면 플러그인은 GPU 선택 단계로 돌아가며, 사용자가 확인하지 않은 구성으로 자동 전환하지 않습니다.
유료 확인 정보를 꼼꼼히 확인하세요
플러그인 자체는 무료지만 클라우드 플랫폼은 GPU, 시스템 디스크, 이미지 등의 리소스에 비용을 청구합니다. 리소스 생성을 확인하기 전에 선택한 GPU, 예상 비용 및 동영상 매개변수를 확인하여 잘못된 구성으로 인한 불필요한 지출을 방지해야 합니다.
자동 종료 기능으로 비용을 관리하세요
플러그인은 기본적으로 30분 후 안전 종료를 제공하며, 단일 작업이 완료되거나 실패하면 즉시 종료합니다. 그래도 사용자는 작업 상태와 클라우드 플랫폼의 리소스 페이지를 확인하여 인스턴스가 예상대로 중지되었는지 확인해야 합니다.
대화에 API Key를 노출하지 마세요
API Key는 CompShare CLI를 통해 로컬 컴퓨터에 저장해야 하며, Codex 대화, 로그, 스크린샷 또는 공개 질문에 전송해서는 안 됩니다. 플러그인의 정상적인 절차에서는 채팅 내용으로 자격 증명을 입력하도록 요구하지 않습니다.
입력 유형에 맞는 생성 방식을 선택하세요
- 창의적인 설명만 있는 경우 텍스트-투-비디오를 사용합니다.
- 시작 또는 종료 장면을 제어해야 하는 경우 키프레임 기반 동영상 생성을 사용합니다.
- 여러 시각 자료를 참고해야 하는 경우 참고 이미지 기반 동영상 생성을 사용하고 이미지 수를 1~9장으로 제한합니다.
사용 전에 모델 라이선스를 확인하세요
플러그인 코드는 MIT License를 사용하지만 모델과 워크플로에는 각각의 라이선스 요구 사항이 있습니다. MiniMax H3 Community License Agreement를 확인하는 것 외에도 저장소의 타사 라이선스 안내를 읽고 자신의 지역 및 용도가 요구 사항을 충족하는지 확인해야 합니다.
자주 묻는 질문
플러그인에 MiniMax H3 모델 가중치가 포함되어 있나요?
포함되어 있지 않습니다. README에 저장소가 MiniMax H3 모델 가중치를 제공하지 않는다고 명시되어 있습니다.
Windows에서 사용할 수 있나요?
README에 기재된 지원 환경은 macOS 또는 Linux이며, Windows 지원 여부는 명시되어 있지 않습니다.
현재 어떤 클라우드 플랫폼을 지원하나요?
현재는 优云智算만 지원하며, 프로젝트는 향후 다른 플랫폼도 추가할 예정입니다.
GPU 재고가 없으면 다른 구성으로 자동 변경되나요?
아니요. 조건에 맞는 리소스를 찾지 못하면 플러그인은 GPU 선택 단계로 돌아가며, 확인 없이 다른 구성으로 전환하지 않습니다.
생성된 동영상은 어디에 저장되나요?
기본적으로 ~/.local/share/minimax-h3-cloud/outputs/에 저장됩니다.
요약
MiniMax H3 Cloud for Codex는 클라우드 GPU 선택, ComfyUI Runtime 준비, 동영상 워크플로 실행, MP4 다운로드 및 인스턴스 종료를 Codex 대화 흐름에 통합합니다. 필요한 종속 요소를 설치하고 로컬 자격 증명을 구성하면 텍스트, 키프레임 또는 1~9장의 참고 이미지로 동영상을 생성할 수 있습니다. 실제로 사용할 때는 모델 라이선스, 실시간 리소스 가격, 유료 리소스 확인 및 API Key 보안에 특히 주의해야 합니다.