MiniMax 공식 비디오
이 스킬의 scripts/minimax_video.py를 사용하여 MiniMax 공식 V2 인터페이스에 직접 연결합니다. 기본 국내 엔드포인트는 https://api.minimax.cn이고, 국제 엔드포인트는 https://api.minimax.io이며, 기본 모델은 MiniMax-H3입니다. 일반적인 MiniMax 신규 작업에는 이 스킬을 사용하세요. '나두퉁' 태스크는 원래 클라이언트에서만 확인해야 하며, 작업 ID는 서비스 간에 마이그레이션되지 않습니다.
설정
- 실제 스킬 설치 디렉터리에서 스크립트를 찾습니다. 우선
~/.config/minimax/venv/bin/python을 사용합니다. 일반 텍스트, HTTPS 또는mm_file://입력에는 Python 3.9+만 있으면 됩니다. 로컬 미디어 검증 및 옵션 R2 사용에는scripts/requirements.txt의 종속성이 필요합니다. - 자격 증명은
MINIMAX_API_KEY에서 읽어오며, 환경 변수가 우선되고 그 다음~/.config/minimax/env를 구문 분석합니다. 다른 앱의 채팅 자격 증명은 읽지 않으며, 키를 스킬, 명령줄 또는 작업 기록에 기록하지 않습니다. 국내/국제 엔드포인트 및 도구 환경은 설정 및 복구를 참조하세요. - 키가 없으면 macOS에서는
scripts/configure.py --region cn --gui를 사용하여 숨김 입력 상자에 설정하고, 다른 시스템에서는 사용자 터미널에서 숨겨서 입력하세요. 사용자가 키를 채팅에 보내도록 요구하지 마세요. 사용자가 이미 환경 변수를 가지고 있다면--from-env를 사용하고, 교체하려면--replace-key를 사용하세요. doctor --check-api는 최근 작업 목록만 읽어 인증 및 V2 조회 인터페이스를 확인합니다. 잔액, 특정 모델 생성 권한 또는 최종 비디오 품질을 증명하지 않습니다. 설치, 설정, 인터페이스 연구를 위해 유료 생성을 승인하지 않습니다.
파라미터 및 입력
모델, 비기본 파라미터 또는 멀티모달 재료를 선택할 때는 먼저 공식 인터페이스 및 기능을 읽고, '나두퉁'의 모델 ID, 720p/960p 사양 또는 4–12초 제한을 그대로 사용하지 마세요.
- 기본 프리셋은 H3, 4초, 768P입니다. 일반 텍스트의 기본 비율은 16:9이고, 시작/종료 프레임은 입력 이미지에 따라 비율이 결정됩니다. 네 가지 H3 모델의 해상도, 시간 및 참조 비율 제한이 다르므로 클라이언트가 모델에 따라 검증합니다.
--first-frame,--last-frame은 각각 최대 하나씩입니다. 멀티모달 참조는 반복 가능한--ref-image,--ref-video,--ref-audio를 사용합니다. 시작/종료 프레임은 멀티모달 참조와 혼용할 수 없습니다. 재료 순서를 유지하고 프롬프트에서 "참조 이미지1", "참조 비디오1" 등 역할을 명확히 지정하세요.- 재료는 로컬 파일, HTTPS URL, 현재 공식 계정의
mm_file://핸들을 지원합니다. 로컬 입력은 먼저 불변 복사본을 저장하고 형식, 크기, 시간 등을 검증합니다. 원격 입력의 미디어 사양은 공식에서 검증하며, 로컬에서 검토했다고 주장하지 않습니다. - 작은 로컬 재료는 기본적으로
--delivery inline을 사용하며, 공식 data URI 형식으로 생성 요청과 함께 전송되므로 타사 호스팅이 필요하지 않습니다. Base64 팽창 후 총 요청 크기는 64 MB를 초과할 수 없습니다. 로컬 MOV 또는 큰 재료는 명시적으로--delivery r2를 사용한 후host를 실행할 수 있습니다. 제한을 우회하기 위해 사용자 원본 파일을 자동으로 업로드, 트랜스코딩 또는 수정하지 않습니다. - R2 모드는 설정된 프라이빗 버킷만 사용하며, 해시별로 객체를 재사용하고 익명 다운로드를 검증합니다. 업로드 전 대상 프로젝트의 미디어 및 개인정보 보호 규칙을 준수합니다. 현재 작업이 허용하는 미디어 범위 내에서만 호스팅합니다. 설정 또는 호스팅 실패 시 보고하며, 자동으로 이미지 호스팅을 변경하지 않습니다.
제작 및 확인
사용자가 비디오 생성을 요청하면 하나의 후보를 완성합니다. 배치 및 추가 시도는 이번 규칙을 따릅니다. 각 후보는 새 작업 디렉터리를 사용하며, 우선 프로젝트에서 무시되는 tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/에 배치합니다. 프로젝트가 없으면 작업 공간 임시 디렉터리나 사용자가 지정한 위치를 사용하며, 기존 작업을 덮어쓰지 않습니다.
doctor --check-api로 설정을 확인합니다. 액션, 장면, 캐릭터/소품 제약 및 사운드 요구 사항을 UTF-8 프롬프트 파일에 기록하고,prepare로 프롬프트, 공식 파라미터, 서비스 지역 및 입력 복사본을 고정합니다. 이 단계는 오프라인이며 비디오를 생성하지 않습니다.--delivery r2이고 로컬 재료가 포함된 경우에만host를 실행합니다. 이 작업은 재료를 프라이빗 R2에 업로드하고 MiniMax가 서명된 링크를 사용하도록 합니다. 인라인 재료는 MiniMax에 직접 전송됩니다.submit을 한 번 실행합니다. 클라이언트는 유료 POST 전에 제출 레코드와 요청 해시를 독점적으로 저장합니다. 공식 문서에 idempotency 키가 명시되지 않았으므로, 로컬 요청 UUID를 서버 측 중복 제거 보장으로 사용할 수 없습니다.- 별도의
status쿼리를 사용하며, 상태는queued/running/succeeded/failed/cancelled입니다. 호스트에서 인터럽트 가능한 대기를 사용하고 진행 상황을 전달하며, 긴 셸 명령에서 수 분 동안 폴링하지 않습니다. - 성공 후
download로 MP4를 다운로드, 검증 및 해시를 저장합니다. 다운로드 실패 시status/download만 재시도합니다. 만료된 미디어 URL은 다시 쿼리하여 새로 고칠 수 있습니다. 공식은 최근 7일 작업만 조회할 수 있으므로 신속하게 로컬에 저장해야 합니다. - 대화 간 복구는
inspect --job을 먼저 한 후status/download를 수행합니다.submission.json이 있으면 재제출을 방지합니다. 타임아웃, 연결 끊김, 5xx 또는 ID 미반환은 결과가 불명확한 것으로 간주하고 증거를 보존합니다. 읽기 전용tasks를 사용하여 확인을 도울 수 있지만, 모델과 시간이 유사하다고 해서 동일한 작업임을 증명하지는 않습니다. 실패 또는 불명확한 결과에 대해 자동으로 추가 유료 후보를 생성하지 않습니다.
명령 예시 (변수는 모두 실제 절대 경로를 나타내며, JOB은 아직 존재하지 않아야 함):
"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --duration 4 --resolution 768P
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"
일반 텍스트는 --first-frame을 생략하고 필요에 따라 --ratio를 지정합니다. 시작/종료 프레임에는 --last-frame을 추가할 수 있습니다. 멀티모달 참조는 해당 --ref-* 파라미터를 사용합니다. R2 모드는 prepare 시 --delivery r2를 추가하고 submit 전에 host --job "$JOB"를 실행합니다. 전체 옵션은 스크립트 --help를 참조하세요.
전달
재생 가능한 로컬 video.mp4와 작업 디렉터리를 전달하고, 절대 경로로 비디오를 표시합니다. 실제 모델, 시간, 해상도, 비율 및 사운드 성능과 원본 속도 비디오, 시작/종료 프레임 및 캐릭터 일관성을 검토했는지 여부를 설명합니다. HTTP 성공이 비주얼 승인과 같지는 않습니다.
작업 기록에는 프롬프트, Base64 미디어, 서명된 URL 및 실제 작업 ID가 포함되며, 현재 사용자만 읽을 수 있고 전체를 채팅에 붙여넣거나 Git에 제출하지 않습니다. 콘솔에 작업 지문을 표시합니다. 공식 API Bearer는 허용된 공식 API 호스트로만 전송되며, 최종 비디오와 모든 리디렉션은 익명 HTTPS로 다운로드됩니다.