[Image 1]、[Image 2] のように参照し、img_uuid で非同期タスクを追跡します。HappyHorse 1.1 リファレンスAPI
独立したGoEnhance APIを通じて、リファレンスガイド付き動画を生成します。1〜9個の公開画像URLを送信し、プロンプト内で
APIキーを取得
リファレンスから動画へのリクエストを作成
1〜9枚のリファレンス画像で動きをガイド
model: happyhorse-1-1-ref を指定して https://api.goenhance.ai/api/v1/videos/generations にPOSTリクエストを送信します。必須の image_urls 配列には、1〜9個の公開画像URLを指定できます。
構図と完成度をコントロール
プロンプト、比率、長さ、解像度を設定し、返された img_uuid を保持します。GET /api/v1/jobs/detail をポーリングするか、公開HTTPS URLでステータス変更のコールバックを受け取ります。
生成タスクを送信する前に、すべてのフィールドを検証してください。
HappyHorse 1.1 リファレンスAPIの機能
リファレンス専用入力モード
このルートには <code>image_urls</code> が必須であり、純粋なテキストから動画への生成はサポートしていません。
1〜9枚のリファレンス画像
プロンプトで使用する順序で、1〜9個の公開画像URLを提供してください。
インデックス付きプロンプト参照
入力内容を <code>[Image 1]</code>、<code>[Image 2]</code> のように明示的に参照してください。
7つのアスペクト比
16:9、9:16、3:4、4:3、4:5、5:4、1:1から選択します。デフォルトは16:9です。
3〜15秒の長さ
3秒から15秒の間で整数値を設定します。ドキュメント上のデフォルトは5秒です。
720pまたは1080p
720pまたは1080pの出力を選択します。ドキュメント上のデフォルトは720pです。
料金は生成された秒数に基づき、ドキュメントに記載された1トークンあたり$0.02の換算レートで計算されます。
HappyHorse 1.1 リファレンスAPIの料金
720pの料金
生成1秒あたり5.2トークン（1秒あたり$0.104相当）。
1080pの料金
生成1秒あたり7.2トークン（1秒あたり$0.144相当）。
各リクエストの見積もり
選択した秒単価に長さを掛けます。例えば、720pで5秒の場合、26トークンを使用します。
6つのステップでHappyHorse APIを統合する
1
1. APIキーを作成する
GoEnhanceキーを作成し、Authorizationヘッダーのベアラートークンとして送信してください。
2
2. リファレンス画像をホストする
公開されている画像URLを1〜9個、指定された配列順で提供してください。
3
3. インデックス付きプロンプトを作成する
各入力を
[Image N] と指定しながら、動きや関係性を記述します。 4
4. 出力設定を検証する
サポートされているアスペクト比、3〜15秒の再生時間、720pまたは1080pの解像度を選択してください。
5
5. 送信してIDを保持する
タスクをPOSTし、完了イベントを処理する前に返された
img_uuid を保存してください。 6
6. ポーリングまたはコールバックを受信する
ジョブ詳細エンドポイントをポーリングするか、公開HTTPSコールバックURLでステータスの変更を処理します。
承認済みのビジュアル入力に基づいて、繰り返し可能なビデオワークフローを構築します。
HappyHorseリファレンスAPIのユースケース
キャラクターの一貫性
承認されたキャラクターのリファレンスを使用して、生成されたショット全体でアイデンティティとスタイルを維持します。
製品のストーリーテリング
製品、設定、ムードのリファレンスを、プロンプト主導のビデオコンセプトに組み込みます。
キャンペーンのバリエーション
1つのタスクハンドラーを維持しながら、リファレンスセットとプロンプトをパラメータ化してクリエイティブなバリエーションを作成します。
絵コンテの開発
ビジュアルボードやアートディレクションのリファレンスを、レビュー用の短いモーションコンセプトに変換します。
ローカライズされたクリエイティブ
検証および完了ワークフローを維持しながら、承認済みの地域別リファレンスを入れ替えます。
プリビジュアライゼーション
本格的な制作に入る前に、複数の参照対象間のインタラクションを検討します。
入力、料金、非同期統合に関する一般的な質問への回答。