チュートリアル

EvoLinkでHappyHorse APIを使う方法

Q: HappyHorseにはどのエンドポイントを使えばよいですか？

POST /v1/videos/generations でタスクを作成し、GET /v1/tasks/{task_id} でタスクのステータスと結果を取得します。

Q: どのHappyHorseモデル名を使うべきですか？

プロンプト主導のテストには happyhorse-1.0-text-to-video から始めてください。画像、リファレンス、ソースビデオが必要なワークフローでは、happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video、happyhorse-1.0-video-edit を使用します。

EvoLink Team

Product Team

2026年4月27日

6 分

HappyHorse APIガイド：EvoLinkからHappyHorse 1.0を呼び出す

HappyHorse 1.0がEvoLinkの統合ビデオAPIで利用可能になりました。**「HappyHorse API」**を探しているなら、最短ルートはHappyHorse APIページです。モデルのテスト、現在のルート料金の確認、ライブAPIの詳細確認がすべてそこで行えます。

このガイドでは開発者向けのワークフローを解説します。モデルページがトランザクショナルクエリを担当し、この記事が統合の詳細をカバーする構成です。

早わかりまとめ

POST /v1/videos/generations でHappyHorseのビデオタスクを作成します。
GET /v1/tasks/{task_id} で非同期の結果をポーリングします。
現在利用可能なルートバリアントは happyhorse-1.0-text-to-video、happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video、happyhorse-1.0-video-edit です。
EvoLinkのルート料金は秒単位です。現在の料金表では720pが 12.15 クレジット/秒、1080pが 1.778倍 の乗数となっています。
APIアクセス、料金、PlaygroundでのテストにはHappyHorse APIページをご利用ください。

HappyHorse APIのモデル名

ワークフロー	モデル名	最適な用途
テキストから動画	`happyhorse-1.0-text-to-video`	プロンプト主導のビデオ生成
画像から動画	`happyhorse-1.0-image-to-video`	最初のフレーム画像をアニメーション化
リファレンスから動画	`happyhorse-1.0-reference-to-video`	1～9枚のリファレンス画像の使用
動画編集	`happyhorse-1.0-video-edit`	テキスト指示でソースビデオを編集

これらのバリアントはEvoLinkで同じ基本パターンを共有しています。非同期の生成タスクを送信し、タスクIDを受け取り、タスク完了時に結果を取得します。

基本リクエストパターン

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-text-to-video",
    "prompt": "A cinematic product shot of a chrome horse sculpture rotating on a black glass table, studio lighting, slow camera push-in",
    "quality": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

レスポンスでタスクIDが返されます。そのタスクIDを使ってタスクエンドポイントをポーリングします：

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<TASK_ID> \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>'

まず確認すべきパラメータ

パラメータ	代表的な値	備考
`model`	`happyhorse-1.0-text-to-video`	ワークフローに合ったHappyHorseバリアントを選択
`prompt`	テキストプロンプト	プロンプト主導の生成・編集で必須
`quality`	`720p`, `1080p`	1080pはより高い乗数が適用される
`duration`	`3-15` 秒	生成バリアントに適用、動画編集には不適用
`aspect_ratio`	`16:9`, `9:16`, `1:1`, `4:3`, `3:4`	テキストから動画とリファレンスから動画でアスペクト比選択が可能
`image_urls`	画像1枚またはリファレンス1～9枚	画像/リファレンスワークフローで必須
`video_urls`	ソースビデオのURL	動画編集で必須

HappyHorseバリアントの使い分け

テキストから動画は、HappyHorseの品質を最もシンプルにテストしたいときに使います。happyhorse api や happyhorse テキスト動画 の一般的な検索に最適です。

画像から動画は、開始フレームが重要なときに使います。商品ビジュアル、キャラクターの一貫性、デザイン主導のクリエイティブテストに向いています。

リファレンスから動画は、複数のリファレンス画像があり、プロンプト内でそれらをキャラクターやオブジェクトとして参照したいときに使います。

動画編集は、すでにソースビデオがあり、テキスト指示で変更を加えたいときに使います。動画編集の料金は出力の長さだけでなく、合計再生時間のルールに基づきます。

料金の範囲

このガイドで説明するのはEvoLinkのルート料金であり、ベンダーの公式価格ではありません。

現在のHappyHorse料金体系は以下の通りです：

画質	料金基準
720p	`12.15 クレジット/秒`
1080p	720p料金の `1.778倍`

動画編集には特別な再生時間ルールがあります。入力ビデオの再生時間と出力ビデオの再生時間の合計で課金され、ソースビデオの再生時間には課金上限があります。本番利用の前に、必ずHappyHorse APIページでライブ料金表を確認してください。

このページのSEOクラスター上の位置づけ

検索クエリ	最適な遷移先
`happyhorse api`	HappyHorse APIページ
`happyhorse api 使い方`	このガイド
`happyhorse 料金`	HappyHorse料金ガイド
`happyhorse vs seedance`	HappyHorse vs Seedance
`happyhorse open source`	HappyHorseリリースウォッチ

HappyHorse APIページを開く

FAQ

HappyHorse APIは今すぐ利用できますか？

はい。HappyHorse 1.0は現在、EvoLinkの統合ビデオAPIを通じて呼び出し可能です。

HappyHorseにはどのエンドポイントを使えばよいですか？

POST /v1/videos/generations でタスクを作成し、GET /v1/tasks/{task_id} でタスクのステータスと結果を取得します。

どのHappyHorseモデル名を使うべきですか？

プロンプト主導のテストには happyhorse-1.0-text-to-video から始めてください。画像、リファレンス、ソースビデオが必要なワークフローでは、happyhorse-1.0-image-to-video、happyhorse-1.0-reference-to-video、happyhorse-1.0-video-edit を使用します。