HappyHorse API
720p/1080p 출력과 캐릭터 가이드 클립을 지원하는 텍스트, 이미지, 편집 비디오 생성을 위한 HappyHorse API 액세스.
curl -X POST https://runapi.ai/api/v1/happyhorse/image_to_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-text-to-video",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "밤에 미니어처 골판지 도시를 질주하는 종이 말의 5초짜리 1080p 시네마틱 클립을 생성해 주세요."
}'
import { HappyhorseClient } from "@runapi.ai/happyhorse";
const client = new HappyhorseClient();
const result = await client.imageToVideo.run({
model: "happyhorse-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "밤에 미니어처 골판지 도시를 질주하는 종이 말의 5초짜리 1080p 시네마틱 클립을 생성해 주세요.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Happyhorse\HappyhorseClient;
$client = new HappyhorseClient();
$result = $client->imageToVideo->run([
'model' => 'happyhorse-text-to-video',
'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => '밤에 미니어처 골판지 도시를 질주하는 종이 말의 5초짜리 1080p 시네마틱 클립을 생성해 주세요.',
]);
require "runapi/happyhorse"
client = RunApi::Happyhorse::Client.new
result = client.image_to_video.run(
model: "happyhorse-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "밤에 미니어처 골판지 도시를 질주하는 종이 말의 5초짜리 1080p 시네마틱 클립을 생성해 주세요."
)
npx skills add runapi-ai/happyhorse -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
HappyHorse는 선택 가능한 720p 또는 1080p 출력, 결정론적 시드 제어, 첫 번째 프레임 이미지 안내, 캐릭터 모델을 위한 순서가 있는 참조 이미지 안내, 소스 비디오 편집 지시를 갖춘 텍스트, 이미지, 편집 비디오 클립을 생성합니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
| Variant | Billing | Pricing | |
|---|---|---|---|
| happyhorse-1.0-i2v | second | $0.410 | 보기 → |
| happyhorse-1.0-r2v | second | $0.410 | 보기 → |
| happyhorse-1.0-t2v | second | $0.410 | 보기 → |
| happyhorse-character | second | $0.410 | 보기 → |
| happyhorse-edit-video | second | $0.480 | 보기 → |
| happyhorse-image-to-video | second | $0.410 | 보기 → |
| happyhorse-text-to-video | second | $0.410 | 보기 → |
앱 개발을 위해 HappyHorse skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/happyhorse -g
Install the HappyHorse skill for this app: 1. Add runapi-ai/happyhorse with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
HappyHorse의 위치
HappyHorse는 RunAPI의 Alibaba 카탈로그에 속하며 API, SDK, CLI, Bruno, 문서 전반에 걸쳐 표준 텍스트-비디오, 이미지-비디오, 편집 비디오 기능을 제공합니다.
RunAPI로 HappyHorse을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
HappyHorse는 무엇을 만들 수 있나요?
HappyHorse는 프롬프트로부터 텍스트-비디오, 프롬프트와 순서가 있는 참조 이미지를 사용하는 캐릭터 가이드 텍스트-비디오, 하나의 첫 번째 프레임 이미지로부터 이미지-비디오, 그리고 하나의 소스 클립으로부터 편집 비디오를 제공합니다.
HappyHorse는 어떤 해상도를 지원하나요?
모든 HappyHorse 비디오 엔드포인트는 720p와 1080p 출력을 지원합니다. 1080p가 기본값이며, 720p는 드래프트와 소셜 클립에 유용합니다.
HappyHorse 비디오의 최대 길이는 얼마인가요?
HappyHorse 비디오 생성 엔드포인트는 3~15초의 정수 지속 시간을 지원하며, 편집 비디오는 3~60초의 소스 비디오를 허용합니다.
이미지-비디오는 입력 이미지를 어떻게 활용하나요?
이미지-비디오는 정확히 하나의 공개 이미지 URL을 받아 첫 번째 프레임으로 사용하고, 프롬프트와 설정에 따라 모션을 생성합니다.
캐릭터 모델은 참조 이미지를 어떻게 사용하나요?
캐릭터 모델은 텍스트-비디오 엔드포인트에서 1~9개의 공개 이미지 URL을 받으며, 순서에 따라 프롬프트의 character1, character2 등에 매핑됩니다.
편집 비디오는 소스 비디오를 어떻게 활용하나요?
편집 비디오는 하나의 공개 MP4 또는 MOV 소스 비디오, 편집 지시, 최대 5개의 선택적 참조 이미지를 받습니다.
HappyHorse 결과를 재현할 수 있나요?
동일한 프롬프트, 미디어, 해상도에서 생성을 더 결정론적으로 만들기 위해 시드를 전달할 수 있습니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.