Alibaba · 비디오

Hermes Agent x HappyHorse

HappyHorse는 RunAPI의 Alibaba 카탈로그에 속하며 API, SDK, CLI, Bruno, 문서 전반에 걸쳐 표준 텍스트-비디오, 이미지-비디오, 편집 비디오 기능을 제공합니다.

7 variants 최저 $0.24 / 초 상업적 사용 지원
API 키 받기 Hermes Agent 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 happyhorse-1.0-i2v를 사용하세요: 첫 프레임 이미지 한 장으로 만드는 HappyHorse 1.0 이미지-비디오.

You have access to RunAPI task tools for HappyHorse.

Available HappyHorse models:
- happyhorse-1.0-i2v: 첫 프레임 이미지 한 장으로 만드는 HappyHorse 1.0 이미지-비디오
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-1.0-r2v: 순서가 있는 참조 이미지 1-9장으로 만드는 HappyHorse 1.0 비디오
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-1.0-t2v: 720p 또는 1080p를 지원하는 HappyHorse 1.0 텍스트-비디오
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-character: 1-9개의 순서 있는 참조 이미지로 가이드되는 3-15초 텍스트-비디오 클립
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls
- happyhorse-edit-video: 선택적 참조 이미지와 함께 소스 비디오를 프롬프트로 편집
  endpoints: /api/v1/happyhorse/edit_video
  request fields: model, prompt, source_video_url
- happyhorse-image-to-video: 하나의 첫 프레임 이미지로 3-15초 이미지-비디오 클립
  endpoints: /api/v1/happyhorse/image_to_video
  request fields: model, first_frame_image_url, prompt
- happyhorse-text-to-video: 720p 또는 1080p로 3-15초 텍스트-비디오 클립
  endpoints: /api/v1/happyhorse/text_to_video
  request fields: model, prompt, reference_image_urls

Use the model ID and endpoint that match the user's request.
Example prompt: 밤에 미니어처 골판지 도시를 질주하는 종이 말의 5초짜리 1080p 시네마틱 클립을 생성해 주세요.
/api/v1/happyhorse/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/image_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/happyhorse/image_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/happyhorse/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/text_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/happyhorse/text_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/happyhorse/edit_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/happyhorse/edit_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/happyhorse/edit_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
happyhorse-1.0-i2v
/api/v1/happyhorse/image_to_video
$0.24 / 초 모델 상세
happyhorse-1.0-r2v
/api/v1/happyhorse/text_to_video
$0.24 / 초 모델 상세
happyhorse-1.0-t2v
/api/v1/happyhorse/text_to_video
$0.24 / 초 모델 상세
happyhorse-character
/api/v1/happyhorse/text_to_video
$0.41 / 초 모델 상세
happyhorse-edit-video
/api/v1/happyhorse/edit_video
$0.48 / 초 모델 상세
happyhorse-image-to-video
/api/v1/happyhorse/image_to_video
$0.41 / 초 모델 상세
happyhorse-text-to-video
/api/v1/happyhorse/text_to_video
$0.41 / 초 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + HappyHorse로 만들 수 있는 것

  • 제품 및 마케팅 클립

    작성한 브리프를 바탕으로 제품 페이지, 광고, 랜딩 페이지용 짧은 홍보 영상을 만듭니다.

  • 소셜 미디어 숏폼

    소셜 피드용 짧은 클립을 만들고, 같은 아이디어로 여러 버전을 시도한 뒤 고릅니다.

  • 이미지 애니메이션과 영상 편집

    모델이 이미지-영상 변환이나 영상 편집 엔드포인트를 제공하는 경우 정지 이미지를 움직이게 하거나 기존 영상을 수정합니다.

HappyHorse을(를) RunAPI + Hermes Agent로 사용하는 이유

  • 7개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

Hermes Agent + HappyHorse 자주 묻는 질문

HappyHorse는 무엇을 만들 수 있나요?

HappyHorse는 프롬프트로부터 텍스트-비디오, 프롬프트와 순서가 있는 참조 이미지를 사용하는 캐릭터 가이드 텍스트-비디오, 하나의 첫 번째 프레임 이미지로부터 이미지-비디오, 그리고 하나의 소스 클립으로부터 편집 비디오를 제공합니다.

HappyHorse는 어떤 해상도를 지원하나요?

모든 HappyHorse 비디오 엔드포인트는 720p와 1080p 출력을 지원합니다. 1080p가 기본값이며, 720p는 드래프트와 소셜 클립에 유용합니다.

HappyHorse 비디오의 최대 길이는 얼마인가요?

HappyHorse 비디오 생성 엔드포인트는 3~15초의 정수 지속 시간을 지원하며, 편집 비디오는 3~60초의 소스 비디오를 허용합니다.

이미지-비디오는 입력 이미지를 어떻게 활용하나요?

이미지-비디오는 정확히 하나의 공개 이미지 URL을 받아 첫 번째 프레임으로 사용하고, 프롬프트와 설정에 따라 모션을 생성합니다.

캐릭터 모델은 참조 이미지를 어떻게 사용하나요?

캐릭터 모델은 텍스트-비디오 엔드포인트에서 1~9개의 공개 이미지 URL을 받으며, 순서에 따라 프롬프트의 character1, character2 등에 매핑됩니다.

편집 비디오는 소스 비디오를 어떻게 활용하나요?

편집 비디오는 하나의 공개 MP4 또는 MOV 소스 비디오, 편집 지시, 최대 5개의 선택적 참조 이미지를 받습니다.

HappyHorse 결과를 재현할 수 있나요?

동일한 프롬프트, 미디어, 해상도에서 생성을 더 결정론적으로 만들기 위해 시드를 전달할 수 있습니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

Hermes Agent에서 HappyHorse 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기