Happy Horse 1.0 API
Alibaba の Happy Horse 1.0 は、滑らかなカメラワーク、表現力豊かなモーション、高いプロンプト忠実度を備えた、720p / 1080pのシネマティックな動画を生成します。複数の生成にわたってキャラクターやスタイルのアイデンティティを一貫させる、リファレンスから動画も備えています。
720p(デフォルト)または1080pで出力します。テキストから動画、画像から動画、リファレンスから動画(参照からキャラクター、スタイル、ビジュアルのアイデンティティを維持)、video-edit(複数画像の参照に対応)、video-extend のバリアントを用意しています。
概要
Happy Horse 1.0 APIについて
Happy Horse 1.0でできること、Alibabaのモデルラインナップにおける位置づけ、そして多くのチームに選ばれる理由。
Happy Horse 1.0はAlibabaの動画生成モデルで、WaveSpeedAIのREST APIから利用できます。Alibaba の Happy Horse 1.0 は、滑らかなカメラワーク、表現力豊かなモーション、高いプロンプト忠実度を備えた、720p / 1080pのシネマティックな動画を生成します。複数の生成にわたってキャラクターやスタイルのアイデンティティを一貫させる、リファレンスから動画も備えています。
720p(デフォルト)または1080pで出力します。テキストから動画、画像から動画、リファレンスから動画(参照からキャラクター、スタイル、ビジュアルのアイデンティティを維持)、video-edit(複数画像の参照に対応)、video-extend のバリアントを用意しています。
WaveSpeedAIのHappy Horse 1.0ファミリーには、Text-To-Video, Image-To-Video, Video-Extend, Video-To-Video, Reference-To-Videoのワークフローをカバーする5個のRESTエンドポイントがあります。各バリアントには、それぞれ独自の料金、パラメーター、作例があります。入力の種類と本番環境の制約に合うものを選ぶか、同じAPIキーで複数を呼び出して、多段階のパイプラインを組み立ててください。
WaveSpeedAIの他の1,000以上のAIモデルと同じAPIキー、請求アカウント、レート制限の枠組みでHappy Horse 1.0を実行できます。ベンダーごとの設定も、プロバイダーごとのSDKも、ベンダーごとのレート制限も不要です。1つの連携で、テキストから画像、テキストから動画から、音声合成、3D生成、高画質化、編集まで、すべてカバーできます。
エンドポイント
Happy Horse 1.0のAPIエンドポイント一覧
WaveSpeedAIで現在利用可能なHappy Horse 1.0のエンドポイントは5個です。ワークフローに合ったバリアントを選んでください。
/filters:quality(82)/media/images/1777694993627601247_RvFOYvFP.webp)
Happyhorse 1.0 Text To Video
Alibaba Happy Horse 1.0 (Text-to-Video) generates cinematic 720p / 1080p videos from text prompts with smooth camera movement, expressive motion, and strong prompt fidelity. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694942637773181_JtCLV4is.webp)
Happyhorse 1.0 Image To Video
Alibaba Happy Horse 1.0 (Image-to-Video) animates a reference image into a cinematic 720p / 1080p video, optionally guided by a text prompt. Smooth camera movement and expressive, stable motion. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694354473865969_w1wGOX7i.webp)
Happyhorse 1.0 Video Extend
Alibaba Happy Horse 1.0 (Video Extend) extends existing videos with seamless AI-generated continuation, supporting 720p/1080p output. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694893579905189_ykuDNW6V.webp)
Happyhorse 1.0 Video Edit
Alibaba Happy Horse 1.0 (Video Edit) performs prompt-driven video editing with multi-image reference support, supporting 720p/1080p output. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1777694912177671305_rTisAKU3.webp)
Happyhorse 1.0 Reference To Video
Alibaba Happy Horse 1.0 (Reference-to-Video) generates new video scenes guided by reference images, maintaining consistent characters, styles, and visual identity. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
作例
Happy Horse 1.0の実力を見る
Happy Horse 1.0 APIで実際に生成された出力です。動画にカーソルを合わせるとプレビュー、クリックすると原寸のビューアで開きます。
使い方
Happy Horse 1.0 APIの使い方
登録から生成完了まで4ステップ。Python、Node.js、cURLの完全なサンプルは、下のAPIセクションにあります。
- 01
APIキーを取得
WaveSpeedAIのアカウントに登録し、ダッシュボードからAPIキーをコピーします。新規アカウントには無料のスタータークレジットが付くので、課金が始まる前にプレイグラウンドを数十回実行できます。
- 02
予測を送信
入力をJSONとしてhttps://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-videoにPOSTします。エンドポイントはすぐに予測IDを返します。生成は非同期なので、推論中に接続を開いたままにする必要はありません。
- 03
完了までポーリング
https://api.wavespeed.ai/api/v3/predictions/{request_id}/resultにGETします。completedなら出力を返し、failed、cancelled、timeout、deletedならエラーで停止し、それ以外のステータスの間はポーリングを続けます。
- 04
出力URLを読み取る
ステータスが"completed"になったら、data.outputs[0]からURLを読み取ります。URLは、WaveSpeedAIのCDN上にある生成されたメディアを指します。呼び出したHappy Horse 1.0のバリアントに応じて、画像、動画、音声、3Dファイルのいずれかです。
活用例
Happy Horse 1.0で作れるもの
開発者やクリエイターがHappy Horse 1.0 APIでよく使うワークフロー。
滑らかなカメラワークのテキストから動画
alibaba/happyhorse-1.0/text-to-video は、滑らかなカメラワークと表現力豊かなモーションを備えた、720p/1080pのシネマティックなクリップを生成します。これがカタログの目玉です。広告やコンテンツ制作のパイプラインに向く、高いプロンプト忠実度があります。
参照用の静止画から作る画像から動画
alibaba/happyhorse-1.0/image-to-video は、参照画像を、720p/1080pのシネマティックな動画にアニメーション化します。テキストプロンプトで任意にガイドもできます。滑らかなカメラワークと、表現力があって安定したモーションが特長です。
アイデンティティを保つリファレンスから動画
alibaba/happyhorse-1.0/reference-to-video は、参照画像でガイドされた新しい動画シーンを生成し、生成全体でキャラクター、スタイル、ビジュアルのアイデンティティを一貫して維持します。アイデンティティが最も重要なときに選ぶバリアントです。
複数画像の参照による video-edit
alibaba/happyhorse-1.0/video-edit は、複数画像の参照に対応した、プロンプト駆動の動画編集を行います。720p/1080pで出力します。既存のクリップへの狙った編集に便利です。
より長いクリップのための video-extend
alibaba/happyhorse-1.0/video-extend は、既存の動画を、シームレスなAI生成の続きで延長します。720p/1080pで出力します。短い元クリップから、より長いシーケンスを作るのに便利です。
コツ
Happy Horse 1.0のプロンプトのコツ
Happy Horse 1.0からより良い出力を得るための実践的なアドバイス。本番のパイプラインで動画モデル全般に通用するパターンに基づいています。
- 01
アイデンティティが重要なショットにはリファレンスから動画
alibaba/happyhorse-1.0/reference-to-video は、一貫したキャラクター、スタイル、ビジュアルのアイデンティティを保つための専用バリアントです。同じキャラクターを、別々の生成にわたって見分けられる状態に保ちたい、シリーズもののコンテンツに使ってください。
- 02
画像から動画は最初のフレームの構図を保つ
alibaba/happyhorse-1.0/image-to-video は、参照画像を、任意のテキストでのガイド付きで、720p/1080pのクリップにアニメーション化します。開始時の静止画の被写体と構図を保ちながら、カメラと被写体のモーションを加えます。
- 03
服装とポーズを明示的に指定する
服装やポーズを明示しないと、モデルはニュートラルな立ちポーズになりがちです。デフォルトに任せず、衣装と開始時のポーズを具体的に書いて、ショットを制御してください。
- 04
720pと1080pを意図して選ぶ
カタログ上の特長は、シネマティックな720p / 1080pの出力です。720pがデフォルトです。納品解像度が重要な場合に1080pを選んでください。
- 05
リスタイルには、複数画像の参照つきの video-edit を使う
alibaba/happyhorse-1.0/video-edit は、複数画像の参照に対応して、既存の動画にプロンプト駆動の編集を行います。元のモーションと構図を保ったまま、クリップをリスタイルするのに便利です。
料金
Happy Horse 1.0 APIの料金
料金は出力ごとです。最終的な請求額は、各バリアントのプレイグラウンドで設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。
| エンドポイント | タイプ | 最低料金 |
|---|---|---|
| alibaba/ | text-to-video | $0.70 |
| alibaba/ | image-to-video | $0.70 |
| alibaba/ | video-extend | $0.70 |
| alibaba/ | video-to-video | $0.70 |
| alibaba/ | reference-to-video | $0.70 |
API
Happy Horse 1.0 APIを呼び出す
wavespeed.ai/accesskeyでAPIキーに登録し、RESTで予測を送信します。プレイグラウンドでは、入力の組み合わせに応じて、そのまま貼り付けられるサンプルが生成されます。
POSThttps://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)比較
Happy Horse 1.0と他モデルの比較
WaveSpeedAI上の類似モデルではなくHappy Horse 1.0を選ぶべきケース。
Happy Horse 1.0 vs Seedance 2.0
Seedance 2.0 は、全バリアントでのネイティブオーディオ、Turbo 階層、video-edit/video-extend を備えています。Happy Horse はより高価ですが、Seedance とは扱いが異なる、リファレンスから動画と、複数画像の参照に対応した video-edit を備えています。
Happy Horse 1.0 vs Kling 3.0
Kling 3.0 は、Standard、Pro、4K の階層とモーションコントロールをカバーします。Happy Horse は、Kling Pro と 4K の中間に位置し、リファレンスから動画と、複数画像の参照に対応した video-edit を備えています。
Happy Horse 1.0 vs Wan 2.7
Wan 2.7 は、同様のバリアント(テキストから動画、画像から動画、リファレンスから動画、video-edit、video-extend)に加え、同じファミリーに image-edit と text-to-image も備えています。より安価で幅広く、Happy Horse は「滑らかなカメラワーク」と表現力豊かなモーションを軸にしています。
FAQ
Happy Horse 1.0 API — よくある質問
料金、ライセンス、連携など、WaveSpeedAIでHappy Horse 1.0を実行する際のよくある質問。
Happy Horse 1.0 APIとは何ですか?
Happy Horse 1.0は、Alibabaの動画生成モデルで、WaveSpeedAI上でREST APIとして提供されています。Alibaba の Happy Horse 1.0 は、滑らかなカメラワーク、表現力豊かなモーション、高いプロンプト忠実度を備えた、720p / 1080pのシネマティックな動画を生成します。複数の生成にわたってキャラクターやスタイルのアイデンティティを一貫させる、リファレンスから動画も備えています。プログラムから呼び出すことも、上にリンクされたプレイグラウンドで試すこともできます。
Happy Horse 1.0 APIはどう呼び出しますか?
WaveSpeedAIのアカウントに登録し、/accesskeyからAPIキーをコピーして、入力をJSONとしてhttps://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.0/text-to-videoにPOSTします。エンドポイントは予測IDを返します。結果のエンドポイントを約2秒ごとにポーリングし、長時間かかるタスクでは間隔を広げ、終端ステータスになったら停止してください。本番運用向けのPython / Node.js / cURLのサンプルは上にあります。
Happy Horse 1.0 APIの料金はいくらですか?
Happy Horse 1.0は1回あたり$0.70からです。実際の料金は、設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。プレイグラウンドの「生成」ボタンの横に表示されるリアルタイムの料金プレビューで、現在の入力での正確な料金を確認できます。
Happy Horse 1.0にはどのバリアントがありますか?
WaveSpeedAIでは、5個のHappy Horse 1.0エンドポイントが利用可能です:alibaba/happyhorse-1.0/text-to-video, alibaba/happyhorse-1.0/image-to-video, alibaba/happyhorse-1.0/video-extend, alibaba/happyhorse-1.0/video-edit, alibaba/happyhorse-1.0/reference-to-video。各バリアントには、専用のプレイグラウンドページと料金があります。
Happy Horse 1.0の出力を商用利用できますか?
商用利用の権利は、Alibabaのモデルライセンスに従います。Alibabaのほとんどのモデルは出力の商用利用を認めています。具体的なライセンスの概要は各モデルのプレイグラウンドページで、プラットフォーム全体の条件はWaveSpeedAIの利用規約でご確認ください。
なぜ直接ではなくWaveSpeedAIでHappy Horse 1.0を使うのですか?
Happy Horse 1.0と、他のプロバイダーの1,000以上のAIモデルを、1つのAPIキー、1つの請求アカウントで利用できます。ベンダーごとのSDK設定も、個別のレート制限も、ベンダーごとの連携コードの書き直しも不要です。料金は、通常Alibabaの直接のAPIと同等かそれ以下です。
提供元
Alibabaについて
WaveSpeedAIにおけるHappy Horse 1.0と、Alibabaのモデルラインナップ全体を手がけるチーム。
Alibaba の Tongyi Lab は、動画モデルの Wan ファミリーと、LLM の Qwen ファミリーを開発しています。Wan は、オープンウェイトで公開されていること、幅広いバリアント(テキストから動画、画像から動画、リファレンスから動画、video-edit、video-extend、image-edit、text-to-image)を網羅していること、多言語のプロンプトにわたってモーションの安定性とプロンプトへの追従性に一貫して強みがあることが特長です。
WaveSpeedAIでHappy Horse 1.0を使った開発を始めよう
登録時に無料のスタータークレジットを進呈。Alibabaをはじめ、あらゆるプロバイダーの1,000以上のAIモデルを、1つのAPIキーで。