Happyhorse HappyHorse 1.0 Reference to Video API | 요금 및 문서

happyhorse/happyhorse-1.0/reference-to-video

HappyHorse 1.0 Reference to Video는 최대 9개의 참조 이미지를 텍스트 프롬프트와 융합하여 RunComfy에서 3~15초 720P/1080P 클립을 생성합니다. 캐릭터, 의상 및 소품을 Character1/character2 태그로 잠급니다.

1. 시작하기

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

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/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

요청 상태 확인

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": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "image_url_1": {
      "title": "참고 이미지 1(문자 1)",
      "description": "첫 번째 참고 이미지입니다. 프롬프트에서 이 주제에 Character1이라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 짧은 면 ≥ 400px, 720P 이상 권장, 최대 10MB.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
    },
    "image_url_2": {
      "title": "참고 이미지 2(문자2)",
      "description": "선택적 두 번째 참조 이미지. 프롬프트에서 이 주제에 Character2라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_3": {
      "title": "참고 이미지 3(문자3)",
      "description": "선택적인 세 번째 참조 이미지. 프롬프트에서 이 주제에 Character3이라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_4": {
      "title": "참고 이미지 4(문자 4)",
      "description": "선택적인 네 번째 참조 이미지. 프롬프트에서 이 주제에 Character4라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_5": {
      "title": "참고 이미지 5(문자 5)",
      "description": "선택사항인 다섯 번째 참조 이미지. 프롬프트에서 이 주제에 Character5라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_6": {
      "title": "참고 이미지 6(문자 6)",
      "description": "선택적인 여섯 번째 참조 이미지. 프롬프트에서 이 주제에 Character6이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_7": {
      "title": "참고 이미지 7(문자 7)",
      "description": "선택적 일곱 번째 참조 이미지. 프롬프트에서 이 주제에 Character7이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_8": {
      "title": "참고 이미지 8(문자 8)",
      "description": "선택적인 여덟 번째 참조 이미지. 프롬프트에서 이 주제에 Character8이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_9": {
      "title": "참고 이미지 9(문자 9)",
      "description": "선택적인 9번째 참조 이미지. 프롬프트에서 이 주제에 Character9라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 동작, 카메라 및 조명을 설명합니다. 위에 나오는 순서대로 캐릭터1, 캐릭터2, 캐릭터3…의 각 참고이미지를 참고하세요. 최대 중국어 2500자 / 중국어 이외의 문자 5000자.",
      "type": "string",
      "default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
      "maxLength": 5000
    },
    "aspect_ratio": {
      "title": "종횡비(W:H)",
      "description": "출력 비디오 종횡비.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "해상도",
      "description": "출력 비디오 해상도. 해당 모델은 720P 또는 1080P를 지원합니다.",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "duration": {
      "title": "지속",
      "description": "초 단위로 비디오 재생 시간을 출력합니다. 허용되는 값: 3~15.",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "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

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

1. 시작하기

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

3. API 참조

요청 제출

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

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1.0/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png",
    "prompt": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look."
  }'

요청 상태 확인

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)

5. 스키마

입력 스키마

{
  "type": "object",
  "title": "입력 스키마",
  "required": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "image_url_1": {
      "title": "참고 이미지 1(문자 1)",
      "description": "첫 번째 참고 이미지입니다. 프롬프트에서 이 주제에 Character1이라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 짧은 면 ≥ 400px, 720P 이상 권장, 최대 10MB.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7347/media-files/ref-promo-1.png"
    },
    "image_url_2": {
      "title": "참고 이미지 2(문자2)",
      "description": "선택적 두 번째 참조 이미지. 프롬프트에서 이 주제에 Character2라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_3": {
      "title": "참고 이미지 3(문자3)",
      "description": "선택적인 세 번째 참조 이미지. 프롬프트에서 이 주제에 Character3이라는 태그를 지정하세요. 형식: JPEG, JPG, PNG 또는 WEBP. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_4": {
      "title": "참고 이미지 4(문자 4)",
      "description": "선택적인 네 번째 참조 이미지. 프롬프트에서 이 주제에 Character4라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_5": {
      "title": "참고 이미지 5(문자 5)",
      "description": "선택사항인 다섯 번째 참조 이미지. 프롬프트에서 이 주제에 Character5라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_6": {
      "title": "참고 이미지 6(문자 6)",
      "description": "선택적인 여섯 번째 참조 이미지. 프롬프트에서 이 주제에 Character6이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_7": {
      "title": "참고 이미지 7(문자 7)",
      "description": "선택적 일곱 번째 참조 이미지. 프롬프트에서 이 주제에 Character7이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_8": {
      "title": "참고 이미지 8(문자 8)",
      "description": "선택적인 여덟 번째 참조 이미지. 프롬프트에서 이 주제에 Character8이라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "image_url_9": {
      "title": "참고 이미지 9(문자 9)",
      "description": "선택적인 9번째 참조 이미지. 프롬프트에서 이 주제에 Character9라는 태그를 지정하세요. 건너뛰려면 비워 두세요.",
      "type": "string"
    },
    "prompt": {
      "title": "프롬프트",
      "description": "장면, 동작, 카메라 및 조명을 설명합니다. 위에 나오는 순서대로 캐릭터1, 캐릭터2, 캐릭터3…의 각 참고이미지를 참고하세요. 최대 중국어 2500자 / 중국어 이외의 문자 5000자.",
      "type": "string",
      "default": "Cinematic medium close-up. The young woman (character1) with natural blonde hair, blue eyes, and light freckles sits in a bright European-style café by a window, warm morning light on her face. She glances up from her book, gives a warm candid smile toward camera, then returns her gaze to the page. Slow dolly-in, shallow depth of field, identity-locked face and freckle pattern from the reference, soft background bokeh, 8K film look.",
      "maxLength": 5000
    },
    "aspect_ratio": {
      "title": "종횡비(W:H)",
      "description": "출력 비디오 종횡비.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "해상도",
      "description": "출력 비디오 해상도. 해당 모델은 720P 또는 1080P를 지원합니다.",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "duration": {
      "title": "지속",
      "description": "초 단위로 비디오 재생 시간을 출력합니다. 허용되는 값: 3~15.",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "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"
        }
      }
    }
  }
}

HappyHorse 1.0 Reference to Video는 최대 9개의 참조 이미지를 텍스트 프롬프트와 융합하여 RunComfy에서 3~15초 720P/1080P 클립을 생성합니다. 캐릭터, 의상 및 소품을 Character1/character2 태그로 잠급니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

HappyHorse 1.0 Reference to Video는 최대 9개의 참조 이미지를 텍스트 프롬프트와 융합하여 RunComfy에서 3~15초 720P/1080P 클립을 생성합니다. 캐릭터, 의상 및 소품을 Character1/character2 태그로 잠급니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

HappyHorse 1.0 비디오 참조: 다중 이미지 대상-비디오 AI 모델 | 달리다편안하다 | Models and API | RunComfy

HappyHorse 1.0 Reference to Video는 최대 9개의 참조 이미지를 텍스트 프롬프트와 융합하여 RunComfy에서 3~15초 720P/1080P 클립을 생성합니다. 캐릭터, 의상 및 소품을 Character1/character2 태그로 잠급니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마

HappyHorse 1.0 비디오 참조: 다중 이미지 대상-비디오 AI 모델 | 달리다편안하다 | Models and API | RunComfy

HappyHorse 1.0 Reference to Video는 최대 9개의 참조 이미지를 텍스트 프롬프트와 융합하여 RunComfy에서 3~15초 720P/1080P 클립을 생성합니다. 캐릭터, 의상 및 소품을 Character1/character2 태그로 잠급니다.

목차

1. 시작하기

2. 인증

3. API 참조

요청 제출

요청 상태 확인

결과 가져오기

요청 취소

4. 파일 입력

호스트 파일(URL)

5. 스키마

입력 스키마

출력 스키마