logo
RunComfy
  • ComfyUI
  • 트레이너신규
  • 모델
  • API
  • 가격
discord logo
모델
탐색
모든 모델
라이브러리
생성 기록
모델 API
API 문서
API 키
계정
사용량

MiniMax H3 Max Reference to video: Models and API의 다중 모달 비디오 | RunComfy

minimax/minimax-h3-max/reference-to-video

MiniMax H3 Max Reference to video은 이미지, 비디오, 오디오 참조와 프롬프트를 기본 오디오가 포함된 5~15초 480p/768p 클립으로 변환합니다.

목차

1. 시작하기2. 인증3. API 참조요청 제출요청 상태 확인결과 가져오기요청 취소4. 파일 입력호스트 파일(URL)5. 스키마입력 스키마출력 스키마

1. 시작하기

RunComfy API로 minimax/minimax-h3-max/reference-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3-max/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Image 1 is the near man; Image 2 is the far man. Keep both faces, hair, and jackets identical to their reference images. Dusk in an empty asphalt parking lot under soft sodium lights. They stand a few meters apart. The near man says flatly: \"So… you actually tried it?\" A beat of wind. The far man answers with a slow half-smile, warm and certain: \"Yeah. I love it.\" The near man exhales and shakes his head once, almost smiling. Static camera, medium wide. Native audio, lip-synced English dialogue, distant traffic hum, wind. No music, no subtitles, no camera movement, no text, no watermark.",
    "prompt_expansion_mode": "balanced",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-1.webp",
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-2.webp"
    ]
  }'

2. 인증

환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.

3. API 참조

요청 제출

비동기 생성 작업을 제출하면 즉시 request_id와 상태 확인·결과 조회·취소용 URL을 받습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3-max/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Image 1 is the near man; Image 2 is the far man. Keep both faces, hair, and jackets identical to their reference images. Dusk in an empty asphalt parking lot under soft sodium lights. They stand a few meters apart. The near man says flatly: \"So… you actually tried it?\" A beat of wind. The far man answers with a slow half-smile, warm and certain: \"Yeah. I love it.\" The near man exhales and shakes his head once, almost smiling. Static camera, medium wide. Native audio, lip-synced English dialogue, distant traffic hum, wind. No music, no subtitles, no camera movement, no text, no watermark.",
    "prompt_expansion_mode": "balanced",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-1.webp",
      "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-2.webp"
    ]
  }'

요청 상태 확인

request_id의 현재 상태를 가져옵니다("in_queue", "in_progress", "completed", "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

결과 가져오기

지정한 request_id의 최종 출력과 메타데이터를 가져옵니다. 작업이 완료되지 않았으면 현재 상태가 반환되어 폴링을 계속할 수 있습니다.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

요청 취소

request_id로 대기 중인 작업을 취소합니다. 진행 중인 작업은 취소할 수 없습니다.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 파일 입력

호스트 파일(URL)

공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "prompt",
    "prompt_expansion_mode",
    "reference_images"
  ],
  "properties": {
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 모션, 카메라 및 오디오를 설명합니다. 자산을 이미지 1, 이미지 2, 비디오 1, 오디오 1로 참조하고 각 참조가 무엇을 제공하는지 말하세요.",
      "type": "string",
      "default": "Image 1 is the near man; Image 2 is the far man. Keep both faces, hair, and jackets identical to their reference images. Dusk in an empty asphalt parking lot under soft sodium lights. They stand a few meters apart. The near man says flatly: \"So… you actually tried it?\" A beat of wind. The far man answers with a slow half-smile, warm and certain: \"Yeah. I love it.\" The near man exhales and shakes his head once, almost smiling. Static camera, medium wide. Native audio, lip-synced English dialogue, distant traffic hum, wind. No music, no subtitles, no camera movement, no text, no watermark."
    },
    "reference_images": {
      "title": "참조 이미지",
      "description": "프롬프트에 이미지 1, 이미지 2 등으로 인용된 주제 또는 스타일 참조 이미지 URL입니다. 비디오 및 오디오와 결합하여 최대 12개의 참조 파일.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-1.webp",
        "https://playgrounds-storage-public.runcomfy.net/tools/7453/media-files/ref-2.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 12
    },
    "reference_videos": {
      "title": "참조 비디오",
      "description": "비디오 1, 비디오 2로 인용된 모션 참조 클립(각각 약 2-15초, 결합 기간 최대 15초). 이미지 및 오디오와 결합되어 최대 12개의 참조 파일.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 12
    },
    "reference_audios": {
      "title": "참조 오디오",
      "description": "선택적 음성 또는 분위기 클립(각각 약 2~15초, 결합 기간 최대 15초) 유일한 참고자료가 될 수는 없습니다. 최소한 하나의 이미지 또는 비디오를 제공하십시오.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 12
    },
    "aspect_ratio": {
      "title": "화면비",
      "description": "출력 종횡비. adaptive은 가능한 경우 참조 프레임을 따릅니다.",
      "type": "string",
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "adaptive"
    },
    "resolution": {
      "title": "해상도",
      "description": "기본 세대 해상도. 480p은 더 빠르고 저렴합니다. 768p이 더 선명한 기본값입니다.",
      "type": "string",
      "enum": [
        "480p",
        "768p"
      ],
      "default": "768p"
    },
    "duration": {
      "title": "길이",
      "description": "생성된 비디오의 길이(초)(5-15)입니다.",
      "type": "integer",
      "minimum": 5,
      "maximum": 15,
      "default": 5
    },
    "prompt_expansion_mode": {
      "title": "프롬프트 확장 모드",
      "description": "생성 전에 프롬프트를 다시 작성하는 데 얼마나 많은 노력이 소요됩니까? balanced은 빠르게 돌아옵니다. quality은 더 풍부한 프롬프트에 더 오랜 시간을 소비합니다.",
      "type": "string",
      "enum": [
        "balanced",
        "quality"
      ],
      "default": "balanced"
    },
    "seed": {
      "title": "시드",
      "description": "재현 가능한 결과를 위해 시드를 수정했습니다. 임의의 시드에는 -1을 사용합니다.",
      "type": "integer",
      "default": -1
    },
    "enable_safety_checker": {
      "title": "안전 검사기 사용",
      "description": "true로 설정하면 안전 검사가 활성화됩니다.",
      "type": "boolean",
      "default": true
    }
  }
}

출력 스키마

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "단일 이미지 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "단일 동영상 URL"
      },
      "images": {
        "type": "array",
        "description": "여러 이미지 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "여러 동영상 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
팔로우하기
  • 링크드인
  • 페이스북
  • Instagram
  • 트위터
지원
  • 디스코드
  • 이메일
  • 시스템 상태
  • 제휴사
비디오 모델
  • Wan 3.0 Prime Reference To Video
  • Wan 3.0 Prime
  • Wan 3.0 Prime Text To Video
  • Wan 2.6 Flash
  • MiniMax H3 Open Image to Video
  • MiniMax H3 Open
  • 모든 모델 보기 →
이미지 모델
  • Seedream 5.0 Pro Image Edit
  • Qwen Image 3.0 Pro Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2 Image Edit
  • 모든 모델 보기 →
법적 고지
  • 서비스 약관
  • 개인정보 보호정책
  • 쿠키 정책
RunComfy
저작권 2026 RunComfy. All Rights Reserved.

RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.