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 を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
HappyHorseは何を作成できますか?
HappyHorseはプロンプトからのテキスト→動画、プロンプトと順序付けられた参照画像からのキャラクターガイドのテキスト→動画、1枚の最初のフレーム画像からの画像→動画、1つのソースクリップからの動画編集を提供しています。
HappyHorseはどの解像度をサポートしていますか?
すべてのHappyHorse動画エンドポイントは720pと1080pの出力をサポートしています。1080pがデフォルトで、720pはドラフトやソーシャルクリップに便利です。
HappyHorseの動画はどのくらいの長さにできますか?
HappyHorseの動画生成エンドポイントは3〜15秒の整数の尺をサポートし、動画編集は3〜60秒のソース動画を受け付けます。
画像→動画は入力画像をどのように使用しますか?
画像→動画は正確に1つの公開画像URLを受け取り、プロンプトと設定からモーションを生成する前の最初のフレームとして扱います。
キャラクターモデルは参照画像をどのように使用しますか?
キャラクターモデルはテキスト→動画エンドポイントで1〜9個の公開画像URLを受け付けます。その順序はプロンプト内のcharacter1、character2、以降の参照にマッピングされます。
動画編集はソース動画をどのように使用しますか?
動画編集は1つの公開MP4またはMOVのソース動画、編集指示、最大5枚のオプションの参照画像を受け付けます。
HappyHorseの結果を再現できますか?
同じプロンプト、メディア、解像度での生成をより決定論的にするためにシードを渡すことができます。
このモデルはどう呼び出しますか?
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか?
失敗した生成は課金されません
アプリケーションから呼び出せますか?
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。