Skip to main content

概要

HappyHorse (快马) は Alibaba の動画生成モデルシリーズで、高忠実度の動的動画生成に特化しています。テキストの意味を正確に理解し、被写体を安定して保ちながら、滑らかで自然、ディテール豊かで高品質な動画を出力します。APIYI は DashScope パススルー チャネル を通じて直接接続するため、1つの APIYI Key で HappyHorse のすべての機能を呼び出せます。現在のフラッグシップ版である HappyHorse-1.1(Video Edit は 1.0 のまま)では、次の4つの主要なユースケースをカバーします:
🐎 重要ポイント: 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つのキー

Alibaba Cloud のサインアップも、リージョン設定も不要です。1つの APIYI Key で、4つの HappyHorse 機能すべてと Wanシリーズ を呼び出せます。

直接アクセス、VPN 不要

api.apiyi.com に直接接続でき、国内データセンターや家庭用ブロードバンドから利用できます。

失敗時は課金なし

failed 状態に入ったタスク(到達できないメディアURL、機微な prompt など)は課金されませんので、安心して再試行できます。

DashScope プロトコルのパススルー

Wanシリーズと同じエンドポイントとスキーマを共有しているため、既存の Wan のコードは model 名を変えるだけで HappyHorse を呼び出せます。

主な機能

4-in-1 非同期エンドポイント

t2v / i2v / r2v / video-edit は POST /wan/api/v1/...video-synthesis を共有し、送信後に task_id が返されるため、その後ポーリングしてダウンロードします。

高忠実度の被写体保持

このモデルは「高忠実度のダイナミックビデオ」スタイル寄りで、動きの全体を通して人物/オブジェクトをより安定して保ちます。

参照画像は最大 9 枚

happyhorse-1.1-r2v は公式に最大 9 reference_image エントリをサポートしており、複数参照シナリオで被写体の一貫性がより強くなります。

複数の解像度と尺

720P / 1080P の解像度、2〜15 秒の整数の長さ、そして短い prompt の品質を向上させる prompt_extend スマート書き換え。

サポートされているモデル

⚠️ エンドポイントの選択(最重要)

APIYI は 2 つのパスを同時にマウントしますが、HappyHorse のすべての機能を完全に使えるのは DashScope のパススルーエンドポイントだけです
HappyHorse と Wan は同じパススルーエンドポイントを共有しています。ドキュメントやサンプルで、/v1/videos 経由で動画タスクを送信している例を見つけたら、無視してください。すべての作成リクエストは /wan/api/v1/...video-synthesis を経由し、すべてのクエリは /v1/tasks/{task_id} を経由します。

非同期コールフロー

全体のフローは非同期で、3 段階です: タスクを作成 → ステータスをポーリング → 動画をダウンロード.
1

タスクを作成

POST /wan/api/v1/services/aigc/video-generation/video-synthesis、リクエストヘッダー X-DashScope-Async: enable を指定します。すぐに task_id を返します。
2

ステータスをポーリング

GET /v1/tasks/{task_id}Authorization 付きで)、5〜10 秒ごとに問い合わせます(3 秒未満にしないでください)、statuscompleted になるまで続けます。
3

動画をダウンロード

レスポンス内の result_url から mp4 を直接 GET します。Authorization ヘッダーなしで 実行してください(署名付き OSS 直リンクなので、Auth を含めると 403 になります)。

タスクステータスの参照

完全な Python クライアント

主要パラメータの解説

送信時、本文は DashScope のネスト構造を使用します: { model, input: { prompt, media[] }, parameters: {...} }.

media[]の種類

HappyHorse の i2v は driving_audio をサポートしていません(audio-driven は Wan2.7-i2v 専用の機能です)。リップシンク / ラップには Wan2.7 をご利用ください。

parametersの項目

duration整数 5 で、文字列の "5" ではありません。resolution大文字 720P で書くほうがより確実です。

HappyHorse と Wan の選び方

HappyHorse と Wan はどちらも Alibaba の動画モデルで、同じエンドポイントとスキーマを共有しています(model名を変えるだけで相互に置き換え可能です)が、重視するポイントが異なります:
被写体の一貫性を保つために複数の参照画像が必要な場合happyhorse-1.1-r2v を選びます(最大 9 枚)。 リップシンク / ラップ / デジタルヒューマンのボイスオーバーが必要な場合Wan2.7-i2v を選びます(音声駆動に対応している唯一のものです)。

ベストプラクティス

1

まずは 720P / 5秒 で試します

開発中は、低解像度の短い動画で prompt と参照画像をすばやく検証し、確定後に解像度と再生時間を引き上げます。
2

prompt_extend を常に有効にします

prompt_extend: true は短い prompt の品質を大きく向上させます。
3

5-10秒ごとにポーリングします

3秒未満にしないでください(レート制限がかかります)。720P / 5秒 の HappyHorse の各機能は、通常 105–115秒 かかります。
4

保険として 20分 のクライアントタイムアウトを設定します

1080P や長い動画はかなり遅くなります。ポーリングループに 20分 のフォールバックタイムアウトを設定してください。
5

result_url を取得したらすぐにダウンロードします

result_url 24時間で期限切れ が既定であり、署名付きの OSS 直接リンクです — ダウンロード時に Authorization ヘッダーを 含めないでください

エラーコードと再試行

推奨されるクライアントの動作: HTTP 5xx / ネットワークエラーには指数バックオフで再試行し、HTTP 4xx は再試行せず即座に表示します。failed タスクで [InvalidImageUrl] がある場合は再試行可能ですが、[InvalidParameter] / センシティブワードの失敗は再試行できません。

よくある質問

いいえ。 どちらも同じ DashScope パススルー エンドポイント、同じリクエスト構造、同じメディアタイプ名のセット、同じクエリエンドポイントを共有しています。切り替えは model フィールドだけが変わります(例: wan2.7-t2vhappyhorse-1.1-t2v);本文のほかの部分はそのまま同一です。
happyhorse-1.1-i2vdriving_audio(音声駆動)フィールドをサポートしておらず、i2v は first_frame のみ受け付けます。リップシンク / rap / デジタルヒューマンのボイスオーバーには、Wan2.7-i2v を使用してください。
はい。公式には最大 9 reference_image エントリをサポートしており、media 配列に入れるだけです。参照画像が多いほど、被写体 / 衣装 / シーンの一貫性が高まります。
/v1/videos では i2v / r2v の media フィールドのサポートが不完全なため、上流側で [InvalidParameter] Field required: input.media が返されます。作成リクエストはすべて /wan/api/v1/services/aigc/video-generation/video-synthesis を通り、照会は /v1/tasks/{task_id} を通ります。
Authorization ヘッダーを削除してください。result_url はすでに署名済みの OSS 直接リンクであり、APIYI Key を追加すると OSS 側で拒否されます。result_url の有効期限はデフォルトで 24 時間なので、速やかにダウンロードしてください。
status=failed は課金されません。ただし、同じタスクを再送信すると再度課金されるため、冪等性を考慮してください。

グループ設定

HappyHorse と Wan シリーズは 1つの Wan&HappyHorse グループ を共有します — 1つのトークンで両方のシリーズを呼び出せます。動画モデルは 秒単位 で課金されるため、ルーティングを成功させるにはトークンが次の 2 つの条件を満たす必要があります:
  1. 課金モデル: Pay-as-you-go Priority または Pay-as-you-go を選択します — 動画は秒単位で課金されるため、Pay-per-request のトークンではルーティングできません
  2. グループ: Wan&HappyHorse を含むグループを選択します
Token 作成ダイアログ: 課金モデルが Pay-as-you-go Priority に設定され、グループのドロップダウンに Wan&HappyHorse(レート倍率 0.14x)が表示され、1つのトークンを Wan2.7 と 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 の固定為替レート で課金するため、実質的な換算は次のとおりです:
言い換えると、標準価格 = アリババ公式価格の98% です。アリババから直接購入するより安く、海外接続を自前で構築する必要もありません。
換算: 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 倍まで増やせるため、実質価格をさらに下げられます:
そのため、大口のお客様は 公式価格の約81% まで下げられます(0.98 ÷ 1.2 ≈ 0.816)。
  • 課金の単位 = 解像度の段階 × 継続時間(秒)。失敗したタスクは課金されません。
  • 1:7 は 固定の精算為替レート であり、優遇レートではありません。すべての USD チャージに一律で適用されます。
  • 最高の特典階層と対象チャネルについては、チャージ特典 をご覧ください。最新レートは コンソール が正確です。

関連ドキュメント

テキストから動画への Playground

happyhorse-1.1-t2v オンラインデバッグ

画像から動画への Playground

happyhorse-1.1-i2v 最初のフレーム生成

参照から動画への Playground

happyhorse-1.1-r2v 最大 9 枚の参照画像

動画編集 Playground

happyhorse-1.0-video-edit 衣装差し替え / 背景差し替え

Wan シリーズ

また、Alibaba のモデル選択比較も
HappyHorse シリーズは、APIYI DashScope パススルー チャネル経由で提供されます。ご質問やご提案がある場合は、APIYI コンソール でチケットを送信してください。