RunComfy API로 alibaba/happyhorse-1.1/reference-to-video을(를) 실행합니다. 허용되는 입력·출력은 모델 스키마.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'환경 변수 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/alibaba/happyhorse-1.1/reference-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
"prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
}'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": [
"image_url_1",
"prompt"
],
"properties": {
"prompt": {
"title": "프롬프트",
"description": "레퍼런스 이미지를 바탕으로 만들 장면, 동작, 카메라 움직임, 분위기를 설명합니다. 중국어가 아닌 언어는 최대 5000자, 중국어는 최대 2500자이며 초과분은 잘립니다.",
"type": "string",
"default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
"maxLength": 5000
},
"ratio": {
"title": "화면비",
"description": "생성 영상의 가로세로 비율입니다.",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"duration": {
"title": "영상 길이",
"description": "출력 영상의 길이(초)입니다. 허용 범위: 3~15.",
"type": "integer",
"enum": [
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"default": 5
},
"image_url_1": {
"title": "레퍼런스 이미지 1",
"description": "영상의 피사체, 스타일, 구도를 이끄는 기본 레퍼런스 이미지입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
},
"image_url_2": {
"title": "레퍼런스 이미지 2",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_3": {
"title": "레퍼런스 이미지 3",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_4": {
"title": "레퍼런스 이미지 4",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_5": {
"title": "레퍼런스 이미지 5",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_6": {
"title": "레퍼런스 이미지 6",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_7": {
"title": "레퍼런스 이미지 7",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_8": {
"title": "레퍼런스 이미지 8",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"image_url_9": {
"title": "레퍼런스 이미지 9",
"description": "추가 레퍼런스 이미지(선택 사항)입니다. 최대 9장의 레퍼런스 이미지를 함께 사용할 수 있습니다. 지원 형식: JPEG, JPG, PNG, WEBP.",
"type": "string",
"default": ""
},
"resolution": {
"title": "해상도",
"description": "출력 영상의 해상도입니다. Happy Horse 1.1 reference to video는 720P와 1080P를 지원합니다.",
"type": "string",
"enum": [
"720P",
"1080P"
],
"default": "1080P"
},
"seed": {
"title": "시드",
"description": "결과를 재현할 때 사용하는 선택적 시드 값입니다. 0으로 설정하면 제공업체가 무작위로 지정합니다.",
"type": "integer",
"minimum": 0,
"maximum": 2147483647,
"default": 0
},
"watermark": {
"title": "워터마크",
"description": "생성 영상에 제공업체 워터마크를 유지할지 설정합니다.",
"type": "boolean",
"default": false
}
}
}{
"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 도구를 활용하여 놀라운 예술을 창조할 수 있도록 지원합니다.