img_uuidを保存してから、結果を取得するためにポーリングを行うか、HTTPSコールバックを受け取ります。動画生成用HappyHorse 1.1 API
HappyHorse 1.1 APIに、テキストから動画への変換、最初のフレーム画像から動画への変換、または個別の参照画像ワークフローのための独立したGoEnhanceオープンAPIを通じてアクセスします。非同期タスクを送信し、返された
APIキーを作成する
適切なHappyHorse APIモードを選択する
テキストから動画へ
model: happyhorse-1-1 を送信し、必須のプロンプトを指定します（image_url は不要です）。生成する動画の比率、長さ、解像度を選択してください。
最初のフレーム画像から動画へ
image_url を追加して最初のフレームをアニメーション化します。画像はJPEG、PNG、またはWEBP形式で、300px以上、10MB未満、かつ規定の1:2.5から2.5:1の比率範囲内である必要があります。
参照画像から動画へ
model: happyhorse-1-1-ref を使用し、image_urls に1〜9個のURLを指定します。プロンプト内で各ソースを [Image 1]、[Image 2] のように参照してください。
本番環境のキューに作業を送信する前に、選択したリクエストモードを検証してください。
HappyHorse 1.1 APIの機能と制限
2つの標準入力モード
テキストから動画への変換にはプロンプトのみを使用し、最初のフレーム画像から動画への変換には <code>image_url</code> を1つ追加します。
個別のマルチ参照モデル
<code>happyhorse-1-1-ref</code> を使用し、1〜9個の必須参照画像URLを指定します。純粋なテキストから動画への生成には対応していません。
3〜15秒の長さ
<code>duration</code> を3から15秒の整数で設定します。規定のデフォルトは5秒です。
720pまたは1080pの出力
<code>720p</code> または <code>1080p</code> を選択します。規定のデフォルトは <code>720p</code> です。
ポートレート、スクエア、ランドスケープの比率
標準ルートは16:9、9:16、1:1、4:3、3:4に対応しています。参照モードでは4:5と5:4も利用可能です。
ポーリングとコールバック
<code>img_uuid</code> を保持し、ジョブ詳細エンドポイントをポーリングするか、ステータス更新用にパブリックなHTTPSコールバックURLを提供します。
GoEnhanceは、秒単価を1トークンあたり$0.02と記載しており、現在これらの料金を期間限定オファーとしています。
HappyHorse 1.1 APIの価格
720p: 1秒あたり$0.104
720pの生成には1秒あたり5.2トークンを使用します。5秒のリクエストでは26トークン、つまり規定の換算レートで$0.52となります。
1080p：1秒あたり$0.144
1080pの生成には1秒あたり7.2トークンを使用し、生成1秒あたり$0.144に相当します。
期間による見積もり
選択した秒単価に、リクエストする3〜15秒の期間を掛けます。プロモーション価格は変更される可能性があるため、本番環境のバッチ処理の前に最新のAPIリファレンスを確認してください。
HappyHorse 1.1 APIを統合する
1
1. APIキーの作成と保護
GoEnhanceキーを作成し、信頼できるサーバーサイドコードからBearer認証として送信します。
2
2. モデルの選択
プロンプトのみ、または最初のフレームからの生成には
happyhorse-1-1を、1〜9枚の参照画像を使用する場合はhappyhorse-1-1-refを選択してください。 3
3. ペイロードの構築と検証
必要なプロンプトを提供し、選択したモードに応じて画像フィールド、期間、解像度、比率、およびコールバックURLを検証します。
4
4. 動画タスクの送信
https://api.goenhance.ai/api/v1/videos/generationsにPOSTし、返されたimg_uuidを保存します。 5
5. ステータスの追跡
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...をポーリングするか、パブリックHTTPSコールバックでステータスの変更を受け取ります。 6
6. 最終結果の処理
成功および失敗を冪等（べきとう）に処理し、返されたアセットを検証します。また、ポーリングとコールバックが重複した際に下流工程で重複作業が発生しないようにします。
構造化された生成リクエストを、レビュー、ストレージ、および配信ワークフローに接続します。
HappyHorse APIの開発者向けユースケース
キャンペーン動画のバリエーション
クリエイティブなレビューやその後の編集のために、構造化されたプロンプトから短いモーションコンセプトを生成します。
製品およびブランドのモーション
承認済みの最初のフレームをアニメーション化し、バックエンドで期間、解像度、完了処理を制御します。
キャラクターのインタラクション研究
参照モデルを使用して、承認済みのソース画像から被写体が1つのシーンでどのように表示されるべきかを記述します。
絵コンテのプレビジュアライゼーション
より大規模な制作ワークフローに着手する前に、ショットの説明をレビュー可能なクリップに変換します。
ローカライズされたクリエイティブパイプライン
タスクの送信と監視を一貫させながら、地域ごとのバリエーションに合わせてプロンプトをパラメータ化します。
自動化されたアセットキュー
生成、ジョブ状態の永続化、コールバック、ストレージ、および人間による承認をバックエンドサービスで接続します。
料金、リクエストモード、入力制限、非同期タスク処理に関する回答。