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"
]
}'환경 변수 YOUR_API_TOKEN 에 API 키를 설정하세요( 프로필에서 키 관리). 모든 요청에 Authorization 헤더로 Bearer 토큰을 포함: Authorization: Bearer $YOUR_API_TOKEN.
비동기 생성 작업을 제출하면 즉시 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>"공개적으로 접근 가능한 HTTPS URL을 제공하세요. 서버 측 페치가 가능하고(로그인/쿠키 불필요) 속도 제한이나 봇 차단이 없어야 합니다. 권장: 이미지 ≤ 50MB(약 4K), 동영상 ≤ 100MB(720p 기준 약 2–5분). 비공개 자산은 안정적이거나 사전 서명 URL을 권장합니다.
{
"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"
}
}
}
}
}RunComfy는 최고의 ComfyUI 플랫폼으로서 ComfyUI 온라인 환경과 서비스를 제공하며 ComfyUI 워크플로우 멋진 비주얼을 제공합니다. RunComfy는 또한 제공합니다 AI Models, 예술가들이 최신 AI 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.