/happyhorse/videos エンドポイントと action パラメータを通じて、テキストからの動画生成、開始フレーム画像からの動画生成、参照画像からの動画生成、および動画編集をサポートします。
申請手順
HappyHorse Videos API を使用するには、まず Ace Data Cloud コンソール にアクセスして API Token を取得し、控えておいてください。
まだログインまたは登録していない場合は、ログインページに自動的にリダイレクトされ、登録とログインが案内されます。完了後、自動的に現在のページへ戻ります。
1 つの API Token でプラットフォーム上のすべてのサービスを呼び出すことができ、サービスごとに個別に申請する必要はありません。 初回申請時には無料クレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント:HappyHorse Videos API →
操作タイプ
action は、今回のリクエストの生成モードを決定します。
generate:テキストからの動画生成。デフォルトの action であり、happyhorse-1.0-t2vとhappyhorse-1.1-t2vをサポートします。promptの指定が必須です。image_to_video:開始フレーム画像からの動画生成。happyhorse-1.0-i2vとhappyhorse-1.1-i2vをサポートします。image_urlの指定が必須です。reference_to_video:参照画像からの動画生成。happyhorse-1.0-r2vとhappyhorse-1.1-r2vをサポートします。promptと 1~9 枚のimage_urlsの指定が必須です。video_edit:動画編集。happyhorse-1.0-video-editをサポートします。promptとvideo_urlの指定が必須で、追加で 0~5 枚の参照画像image_urlsを指定できます。
video_edit は現在 happyhorse-1.0-video-edit のみです。
基本的な使用方法
テキストからの動画生成ではprompt のみを指定すればよく、resolution、ratio、duration などのパラメータも指定できます。
success:今回のリクエストが成功したかどうか。task_id:Ace Data Cloud 側のタスク ID。タスク状態の照会に使用できます。trace_id:今回のリクエストのトラッキング ID。問題の調査に使用されます。data:動画結果のリスト。id:HappyHorse 側のタスク ID。video_url:生成された動画の CDN リンクアドレス。state:タスク状態。pending/succeeded/errorから選択できます。duration:課金対象となる動画の長さ。単位は秒です。video_editでは入力動画と出力動画の長さの合計です。resolution:出力解像度。ratio:出力アスペクト比。
開始フレーム画像からの動画生成
image_to_video を使用する場合、image_url は動画の開始フレームとして使用されます。出力アスペクト比は開始フレーム画像にできる限り追従するため、このアクションでは ratio を指定する必要はありません。
参照画像からの動画生成
reference_to_video を使用する場合、image_urls には 1~9 枚の参照画像を指定できます。プロンプト内では、character1、character2 などを使用して、対応する順序の画像を参照できます。
動画編集
video_edit の出力時間と画面比率は元動画を引き継ぎ、duration または ratio を指定しても変更されません。画像からの動画生成の画面比率も元画像を引き継ぎます。編集料金は、入力動画と出力動画の長さの合計に基づいて計算されます。
video_edit を使用する場合、編集対象動画の video_url と編集意図を示す prompt を指定する必要があります。オプションの image_urls は、衣装変更、スタイル転送、または部分的な置換などの参照画像として使用されます。audio_setting には auto または origin を指定でき、origin は元動画の音声を保持することを意味します。
非同期コールバック
動画生成には一定の処理時間が必要です。長時間接続を維持して待機したくない場合は、callback_url を渡すことができます。この場合、API は直ちに task_id を返し、タスク完了後に最終結果をこのアドレスへ POST します:
"async": true を渡すこともできます。その後、HappyHorse Tasks API を通じてタスク結果を照会します。
課金説明
HappyHorse は出力動画の秒数と解像度に応じて課金します:720P:最低約 $0.105 / 秒。1080P:最低約 $0.18 / 秒。video_edit:入力動画と出力動画の合計時間に基づいて課金され、実際の課金時間はタスク完了後の統計に準じます。
エラー処理
リクエストに問題がある場合、API は対応するエラーコードと説明を返します。一般的なものは以下のとおりです:400:リクエストパラメータが不正です。例えば、action と model が一致しない、prompt/image_url/video_urlが不足している、またはdurationが 3~15 秒の範囲を超えています。401:認証に失敗しました。token が無効であるか、API と一致していません。403:残高不足、またはプロンプトがコンテンツ審査に該当して拒否されました。429:リクエストが頻繁すぎてレート制限が発動しました。しばらくしてから再試行してください。500:サーバー内部エラーまたは生成失敗。

