어느 쪽 MiniMax Video
독립 클라이언트 scripts/nxtpath_minimax_video.py를 사용하며, 고정 게이트웨이는 https://api.nxtpath.ai/v1, 기본 모델은 minimax/minimax-h3입니다. 파라미터는 어느 쪽의 H3 채널을 기준으로 하며, MiniMax 공식 직결 인터페이스나 Seedance 파라미터를 적용하지 않습니다. 확인된 인터페이스 및 검증 범위는 인터페이스 근거를 참조하세요.
설정 및 입력
- 로컬
NXTPATH_API_KEY를 재사용하며, 환경 변수가 우선되고, 그렇지 않으면~/.config/nxtpath/env를 파싱합니다.NXTPATH_ENV_FILE로 파일 경로를 덮어쓸 수 있습니다. Claude, Codex 또는 Grok의 채팅 자격 증명을 읽지 않으며, 키를 명령줄이나 작업 기록에 넣지 않습니다. - 본 스킬의 실제 디렉터리에서 클라이언트를 찾습니다. 우선
~/.config/nxtpath/venv/bin/python을 사용합니다. 텍스트 또는 HTTPS 이미지 입력에는 Python 3.9+만 필요합니다. 로컬 이미지 호스팅에는scripts/requirements.txt의 boto3도 필요하며, 설정 방법은 설정 및 복구를 참조하세요. - 대상 프로젝트의 소재 및 개인정보 보호 규칙을 먼저 읽습니다. 각 후보에는 새로운 작업 디렉터리를 사용하며, 기본적으로 프로젝트에서 무시되는
tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/아래에 배치합니다. 프로젝트가 없으면 현재 작업 공간의 임시 디렉터리 또는 사용자가 지정한 위치를 사용합니다. 기존 작업을 덮어쓰거나 공식 리소스를 자동으로 바꾸지 않습니다. - 기본 샘플은 4초, 720p, 16:9입니다. 길이는 4–12 정수 초, 해상도는 720p / 960p / 2k만 가능하며, 비율은 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16입니다.
- 세 가지 입력 방식: 텍스트 전용;
--first-frame및/또는--last-frame각 최대 1장; 반복 가능한--ref-image일반 참조 이미지. 첫/마지막 프레임과 일반 참조 이미지는 혼용할 수 없으며, 참조 오디오나 참조 비디오는 지원하지 않습니다. 일반 참조 이미지는 첫/마지막 프레임 역할을 하지 않습니다. - 이미지는 HTTPS URL 또는 로컬 PNG/JPEG/WebP(각 최대 20 MiB)를 사용합니다. data URL은 거부합니다. 초대형 이미지는 먼저 축소된 복사본을 저장해야 하며, 사용자 원본 이미지는 변경하지 않습니다.
제작 및 조회
사용자가 비디오 생성을 명시적으로 요청할 때 한 건의 후보를 완료합니다. 일괄 생성 및 재작업 횟수는 이번 약속을 따릅니다. 설정 확인, 인터페이스 연구 또는 스킬 생성만을 위해서는 유료 생성을 승인하지 않습니다. 추가 시도에 대한 약속이 없으면 실패한 작업을 자동으로 재생성하거나 모델을 변경하지 않습니다.
doctor --check-api로 읽기 전용으로 자격 증명,model_available및model_supported를 확인합니다. 모델 검사 중 하나라도 false이면 제출을 중단하고 디렉터리 또는 설정을 확인합니다.- 사용자 요청에 따라 동작, 장면, 지속 시간 및 유지해야 할 캐릭터/소품을 정리하고, 프롬프트를 UTF-8 파일에 기록합니다.
prepare를 사용하여 프롬프트, 매개변수 및 입력 스냅샷을 고정합니다. 이 명령은 오프라인으로 실행되며 비디오를 생성하지 않습니다. - 로컬 이미지가 있으면
host를 실행합니다. 구성된 개인 R2를 사용하며, 콘텐츠 해시 객체를 재사용하고, 24시간 GET을 발행하고 다운로드 해시를 확인합니다. 이 작업은 입력을 R2 및 비디오 제공자에게 전송합니다. 호스팅에 실패하면 중단되며, 공개 이미지 호스팅이나 계정으로 자동 전환하지 않습니다. 텍스트 전용 또는 이미 HTTPS 이미지가 있는 경우 이 단계를 건너뛸 수 있습니다. submit을 한 번 실행합니다. 이 명령은 유료 POST 전에 배타적 제출 기록과 멱등성 키를 영구 저장합니다. 그런 다음 별도의status로 조회합니다. 서비스 상태는Pending/Running/Success/Failure/Expired입니다. 대기 중에는 호스트가 중단 가능한 대기를 사용하고 진행 상황을 계속 소통하며, 긴 셸 호출에서 수 분 동안 루프하지 않습니다.Success이후download로 MP4를 다운로드하고 검증합니다. 다운로드 실패 시 다운로드만 재시도합니다.Failure/Expired는 해당 작업의 최종 상태이며, 결과를 보고하고, 이로 인해 자동으로 새 유료 작업을 생성하지 않습니다.- 크로스 세션 복구는 원래 작업 경로를 사용하여 먼저
inspect한 다음status/download를 실행합니다. 제출 기록, 시간 초과, 연결 끊김 또는 task ID 누락이 있는 경우 다시 POST하지 않습니다. 결과가 불확실하면 개인 기록을 통해 제공자에게 확인하며, 새 시도로 우회하지 않습니다.
명령 예시 (PY, CLIENT, JOB, PROMPT_FILE 및 이미지 변수는 실제 경로를 나타냅니다. JOB은 아직 존재하지 않아야 합니다.):
"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --last-frame "$LAST_FRAME" --duration 4 --resolution 720p --ratio 16:9
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"
첫 번째 프레임만 있는 경우 --last-frame를 생략합니다. 일반 참조 이미지인 경우 --ref-image로 두 프레임 매개변수를 대체합니다. 텍스트-비디오 생성인 경우 모든 이미지 매개변수와 host를 생략합니다. 로컬 NXTPATH_MINIMAX_MODEL 또는 명시적 --model은 지원되는 H3 ID만 선택할 수 있으며, 다른 채널로 자동 폴백하지 않습니다.
전달
재생 가능한 로컬 video.mp4와 작업 디렉터리를 전달하며, 절대 경로로 비디오를 표시합니다. 실제 매개변수와 원속, 동작, 첫/마지막 프레임을 검토했는지 여부를 설명합니다. HTTP 성공이 시각적 품질이나 캐릭터 일관성을 증명하지는 않습니다. 인터페이스가 첫/마지막 프레임을 지원한다고 해서 픽셀 단위 보장은 아니며, 결과는 실제 비디오를 기준으로 합니다.
프롬프트, 서명된 이미지 URL, 작업 핸들 및 응답은 현재 사용자만 읽을 수 있는 기록에 저장됩니다. 전체 내용을 채팅에 붙여넣거나 Git에 커밋하지 마십시오. 콘솔에는 작업 핸들의 지문만 표시합니다. 비디오 Bearer는 이 게이트웨이의 해당 artifact 핸들로만 전송되며, 리디렉션 후의 HTTPS 미디어 다운로드는 익명 요청을 사용합니다.