概要
HappyHorse (快马) は Alibaba の動画生成モデルシリーズで、高忠実度の動的動画生成に特化しています。テキストの意味を正確に理解し、被写体を安定して保ちながら、滑らかで自然、ディテール豊かで高品質な動画を出力します。APIYI は DashScope パススルー チャネル を通じて直接接続するため、1つの APIYI Key で HappyHorse のすべての機能を呼び出せます。現在のフラッグシップ版である HappyHorse-1.1(Video Edit は 1.0 のまま)では、次の4つの主要なユースケースをカバーします:model フィールドだけです。HappyHorse は「高忠実度の動的動画」志向で、Reference-to-Video は 最大9枚の参照画像、Video Edit は 最大5枚の参照画像 をサポートし、強い被写体一貫性を備えています。Wan series と同じエンドポイントを共有しており、そのまま置き換えられます。テキストから動画 API
happyhorse-1.1-t2v、純粋なテキスト prompt から動画を生成します。画像から動画 API
happyhorse-1.1-i2v、先頭フレーム画像から動画を生成します(音声駆動は非対応です)。参照画像から動画 API
happyhorse-1.1-r2v、被写体を保持するために最大9枚の参照画像を使います。動画編集 API
happyhorse-1.0-video-edit、最大5枚の参照画像で動画を編集します。HappyHorse に APIYI を選ぶ理由
すべての機能に1つのキー
直接アクセス、VPN 不要
api.apiyi.com に直接接続でき、国内データセンターや家庭用ブロードバンドから利用できます。失敗時は課金なし
failed 状態に入ったタスク(到達できないメディアURL、機微な prompt など)は課金されませんので、安心して再試行できます。DashScope プロトコルのパススルー
model 名を変えるだけで HappyHorse を呼び出せます。主な機能
4-in-1 非同期エンドポイント
POST /wan/api/v1/...video-synthesis を共有し、送信後に task_id が返されるため、その後ポーリングしてダウンロードします。高忠実度の被写体保持
参照画像は最大 9 枚
happyhorse-1.1-r2v は公式に最大 9 reference_image エントリをサポートしており、複数参照シナリオで被写体の一貫性がより強くなります。複数の解像度と尺
prompt_extend スマート書き換え。サポートされているモデル
⚠️ エンドポイントの選択(最重要)
APIYI は 2 つのパスを同時にマウントしますが、HappyHorse のすべての機能を完全に使えるのは DashScope のパススルーエンドポイントだけです:非同期コールフロー
全体のフローは非同期で、3 段階です: タスクを作成 → ステータスをポーリング → 動画をダウンロード.タスクを作成
POST /wan/api/v1/services/aigc/video-generation/video-synthesis、リクエストヘッダー X-DashScope-Async: enable を指定します。すぐに task_id を返します。ステータスをポーリング
GET /v1/tasks/{task_id}(Authorization 付きで)、5〜10 秒ごとに問い合わせます(3 秒未満にしないでください)、status が completed になるまで続けます。動画をダウンロード
result_url から mp4 を直接 GET します。Authorization ヘッダーなしで 実行してください(署名付き OSS 直リンクなので、Auth を含めると 403 になります)。タスクステータスの参照
完全な Python クライアント
主要パラメータの解説
送信時、本文は DashScope のネスト構造を使用します:{ model, input: { prompt, media[] }, parameters: {...} }.
media[]の種類
parametersの項目
HappyHorse と Wan の選び方
HappyHorse と Wan はどちらも Alibaba の動画モデルで、同じエンドポイントとスキーマを共有しています(model名を変えるだけで相互に置き換え可能です)が、重視するポイントが異なります:
ベストプラクティス
まずは 720P / 5秒 で試します
prompt_extend を常に有効にします
prompt_extend: true は短い prompt の品質を大きく向上させます。5-10秒ごとにポーリングします
保険として 20分 のクライアントタイムアウトを設定します
result_url を取得したらすぐにダウンロードします
result_url 24時間で期限切れ が既定であり、署名付きの OSS 直接リンクです — ダウンロード時に Authorization ヘッダーを 含めないでください。エラーコードと再試行
failed タスクで [InvalidImageUrl] がある場合は再試行可能ですが、[InvalidParameter] / センシティブワードの失敗は再試行できません。よくある質問
HappyHorse と Wan の統合方法に違いはありますか?
HappyHorse と Wan の統合方法に違いはありますか?
model フィールドだけが変わります(例: wan2.7-t2v → happyhorse-1.1-t2v);本文のほかの部分はそのまま同一です。HappyHorse の i2v がなぜリップシンクできないのですか?
HappyHorse の i2v がなぜリップシンクできないのですか?
happyhorse-1.1-i2v は driving_audio(音声駆動)フィールドをサポートしておらず、i2v は first_frame のみ受け付けます。リップシンク / rap / デジタルヒューマンのボイスオーバーには、Wan2.7-i2v を使用してください。happyhorse-1.1-r2v は本当に 9 枚の参照画像を受け付けられますか?
happyhorse-1.1-r2v は本当に 9 枚の参照画像を受け付けられますか?
reference_image エントリをサポートしており、media 配列に入れるだけです。参照画像が多いほど、被写体 / 衣装 / シーンの一貫性が高まります。なぜ /v1/videos から送信できないのですか?
なぜ /v1/videos から送信できないのですか?
/v1/videos では i2v / r2v の media フィールドのサポートが不完全なため、上流側で [InvalidParameter] Field required: input.media が返されます。作成リクエストはすべて /wan/api/v1/services/aigc/video-generation/video-synthesis を通り、照会は /v1/tasks/{task_id} を通ります。result_url をダウンロードすると 403 が返る場合は?
result_url をダウンロードすると 403 が返る場合は?
Authorization ヘッダーを削除してください。result_url はすでに署名済みの OSS 直接リンクであり、APIYI Key を追加すると OSS 側で拒否されます。result_url の有効期限はデフォルトで 24 時間なので、速やかにダウンロードしてください。失敗したタスクは課金されますか?
失敗したタスクは課金されますか?
status=failed は課金されません。ただし、同じタスクを再送信すると再度課金されるため、冪等性を考慮してください。グループ設定
HappyHorse と Wan シリーズは 1つのWan&HappyHorse グループ を共有します — 1つのトークンで両方のシリーズを呼び出せます。動画モデルは 秒単位 で課金されるため、ルーティングを成功させるにはトークンが次の 2 つの条件を満たす必要があります:
- 課金モデル: Pay-as-you-go Priority または Pay-as-you-go を選択します — 動画は秒単位で課金されるため、Pay-per-request のトークンではルーティングできません
- グループ:
Wan&HappyHorseを含むグループを選択します

Create Token: set billing model to Pay-as-you-go Priority and group to Wan&HappyHorse (0.14x) to call every Wan2.7 and HappyHorse video model (the screenshot shows the group's former name Wan, since renamed to Wan&HappyHorse)
価格
標準価格 = アリババ公式価格の98%(単純で分かりやすい)
HappyHorse のモデル価格は APIYI システムに組み込まれています — 手動設定は不要で、グループ割引は自動で適用されます。コンソールではWan&HappyHorse グループが 0.14x のレートで表示され、これは組み込みの RMB 価格単位で算出されています。APIYI は USD を 1:7 の固定為替レート で課金するため、実質的な換算は次のとおりです:
換算: USD の1秒あたり価格 = 公式 RMB 価格 × 0.14(つまり × 0.98 ÷ 7)。
価格詳細(標準価格、秒単位課金)
HappyHorse-1.1 の text-to-video / image-to-video / reference-to-video は同一価格で、2段階の料金設定です —720P / 1080P(480P はサポートされていません):
happyhorse-1.0-video-editの出力時間は元動画に従い、durationではなく実際の出力秒数で課金されます。- 表示価格は 標準(公式の98%) です。最大チャージ特典を適用すると、実質価格は表の値の ÷ 1.2 程度になります(例: 1080P 5 s $1.12 → 約 $0.93)。
さらに低い実質価格を実現する段階的チャージ特典
チャージ特典プログラム に参加すると、付与残高を最大で約 1.2 倍まで増やせるため、実質価格をさらに下げられます:関連ドキュメント
テキストから動画への Playground
happyhorse-1.1-t2v オンラインデバッグ画像から動画への Playground
happyhorse-1.1-i2v 最初のフレーム生成参照から動画への Playground
happyhorse-1.1-r2v 最大 9 枚の参照画像動画編集 Playground
happyhorse-1.0-video-edit 衣装差し替え / 背景差し替え