動画
HappyHorse 1.1
軽やかなクリエイティブ短尺。動きとリズムが軽快。
Ofrai で利用可能 — チャット・画像・動画を同じスタジオで、共有クレジット。
プロンプト例
例を選ぶと、プロンプトと推奨設定が上のHappyHorse 1.1クリエイターに読み込まれます。
使い方
HappyHorse 1.1を3ステップで使う
- 01
入力を用意
HappyHorse 1.1を選択したまま、プロンプトと対応する参照素材を追加します。
- 02
出力を設定
生成前にアスペクト比、解像度、利用可能な動画オプションを選びます。
- 03
生成して調整
結果を確認し、プロンプトや設定を調整して、同じスタジオで別バージョンを生成します。
HappyHorse 1.1 は、1つのモデル ID で4種類の処理を提供します。テキストからの動画生成、最初のフレーム画像からの動画生成、参照画像を使った生成、動画編集は、すべて同じエンドポイントで処理されます。どの処理を行うかは、別々のモデル名ではなく action フィールドで決まります。このフィールドを省略した場合、エンドポイントはエラーを返さずに処理を推定します。
最初のフレーム画像が指定されていれば画像からの動画生成として扱い、指定されていなければテキストからの動画生成として扱います。そのため、パラメーターの動作は処理経路によって異なります。アスペクト比はテキストから生成する場合に適用され、最初のフレームが指定されている場合には無視されます。
プロンプトは3つの経路では必須で、残る1つでは推奨にとどまります。また、解像度のデフォルトは 1080P です。新しい動画エンドポイントでは低価格の基本設定がデフォルトだろうと多くの人が考えがちですが、ここでは逆になっています。
1つのモデル ID、4種類の処理、振り分け用のフィールドは1つ
このエンドポイントの API の使い分けは、action フィールドに集約されています。これを設定すると、テキストからの動画生成、最初のフレーム画像からの動画生成、参照画像からの動画生成、動画編集を明示的に選べます。省略すると、ドキュメントに記載された推定処理が働きます。
最初のフレーム画像があれば画像からの動画生成として処理され、なければテキストからの動画生成として処理されます。便利な仕組みですが、バグが潜みやすい最初の箇所でもあります。テキストから動画を生成するつもりのリクエストに誤って画像を添付しても、拒否されることはありません。画像からの動画生成に振り分けられ、それに伴って各パラメーターの扱いも変わります。
基本方針として、推定でも正しい経路が選ばれる場合を含め、毎回の呼び出しで action フィールドを明示的に設定してください。明示する手間はフィールド1つ分ですが、選択を誤ると、アスペクト比やプロンプトの扱いに意図しないデフォルトが適用されたまま、通知なく動画が生成されます。
デフォルトは 1080P で、一般的な想定とは逆
ここでは解像度のデフォルトが 1080P で、低い解像度として 720P を選べます。このデフォルトは、見た目以上に重要です。このカタログにある大半のエンドポイントは、試行の費用を抑えられるよう低い解像度をデフォルトとし、ショットが固まった段階で高い解像度を選ぶ構成になっています。一方、このエンドポイントは高い解像度がデフォルトなので、未設定のリクエストはフル解像度で生成されます。
このフィールドを設定せずに試行を繰り返しても、費用の節約にはなりません。最初から2つの習慣を付けておくと役立ちます。まず、デフォルトと同じ値を使う場合も含め、呼び出しごとに解像度を明示的に設定し、リクエストを見ればその動作が分かるようにしてください。次に、値の表記に注意してください。選択肢は 1080P と 720P で、P は大文字です。
一部のほかのエンドポイントで使われる小文字の表記とは異なるため、値が拒否されたときにサーバー側の問題だと判断する前に、自分の検証処理を確認する価値があります。
生成時間は3秒から15秒
生成時間の単位は秒で、ドキュメントに記載された範囲は3 から15です。リファレンスでは、具体的な例として3 と15が挙げられています。3秒から15秒という範囲は、ほぼあらゆる短尺コンテンツをカバーできます。
ソーシャルメディア向けのループしやすい3秒の場面、解説動画向けの中程度の長さの場面、連続している必要があるショット向けの15秒のテイクなどです。長さに伴うトレードオフ自体は一般的なものですが、ここでは解像度のデフォルトによって、さらに影響が大きくなります。15秒の 1080P 動画は、このエンドポイントで生成できる最も高額な出力です。
そのため、長さは編集上の判断であると同時に、費用に関する判断でもあります。制作指示の段階でカット位置を計画し、各場面を個別に生成し、分割するとショットが成立しなくなる場合にだけ、1回の長い生成を使ってください。リクエストできる最短時間は3秒なので、1秒未満の短い演出映像が必要な場合、このエンドポイントでは生成できません。
その要件はパイプライン内の別の処理で満たす必要があります。
最初のフレームが画面の形状を決め、入力画像には厳格な制限がある
最初のフレーム画像を指定すると、画面の形状はアスペクト比フィールドではなく、その画像によって決まります。ドキュメントに記載されたアスペクト比の一覧はテキストからの動画生成に適用され、画像からの動画生成はアップロードしたフレームに従います。横長の静止画を指定して 9:16 をリクエストしても、ショットの構図は調整されません。画像自体にも、うっかり違反しやすい厳格な制約があります。
対応形式は JPEG、JPG、PNG、BMP、WEBP です。ファイルサイズは 10MB 以下、幅と高さはそれぞれ 300px 以上でなければならず、アスペクト比は 1:2.5 から 2.5:1 の範囲内である必要があります。これらの範囲を外れたリクエストは、品質を落として処理されるのではなく拒否されるため、送信前に素材処理のパイプラインで確認しておけば、生成をやり直す手間を省けます。
もう1つ間違えやすい点として、最初のフレームに使われるのはリストの最初の画像だけであり、同じ入力に対して複数の別名のフィールドが受け付けられます。どの別名を使う場合でも、ファイルが上記の制限を満たしていることを確認してください。
選択する action によってプロンプトの要件が変わる
プロンプトは、テキストからの動画生成、参照画像からの動画生成、動画編集では必須です。最初のフレーム画像からの動画生成では任意ですが、ドキュメントでは、この場合も指定することを推奨しています。この推奨には従う価値があります。フレームが固定された後に動きやスタイルを制御できる手段は、プロンプトだけだからです。フレームが決まっている場合のプロンプト作成は、ゼロから書く場合とは異なります。
画像にすでに写っている内容を改めて記述すると、モデルが画像と文章の両方に注意を向けることになるためです。被写体の動きを1文、カメラの動きを別の1文で書き、スタイルを表す語句は最後に置いてください。そうすれば、スタイルの指定がほかの指示と競合せず、それらを修飾する形になります。
編集の経路では、プロンプトにシーンそのものではなく、どのように変更するかを記述します。参照画像の経路では、参照画像を踏まえて作るショットを記述します。4つの経路すべてで同じようにプロンプトを書いてしまうことが、ここで生成を無駄にする最も一般的な原因です。
非同期のタスク ID がパイプラインの構築方法を左右する
このエンドポイントのジョブは非同期で実行され、結果はタスク ID を使って取得します。これは一般的で広く理解されている方式ですが、実務上の重要な影響が1つあります。リクエストの送信と結果の取得には時間差があるため、あるクリップを何から生成したかを示す唯一の記録は、送信時に保存した情報になります。
そのため、送信処理ではタスク ID とともに、action、プロンプト、生成時間、解像度、アスペクト比、使用した画像フィールドを含むリクエスト全体を保存する必要があります。モデルが後からそれらを返してくれるわけではありません。設計に関して、関連する注意点が2つあります。このエンドポイントは1つの名前で4種類の処理を提供するため、ポーリングするキューでは異なる経路のタスク ID が混在します。
結果から経路を推測するのではなく、ID と一緒に action を保存してください。また、どの経路でもモデル ID は変わらないため、同一パラメーターで経路を手軽に比較する方法はありません。比較するには、ほかの条件を意識的に固定し、一度に1つの変数だけを変える必要があります。
よくある質問
- デフォルトの解像度と、選択できる値を教えてください。
- デフォルトは 1080P で、低い解像度として 720P を選べます。低価格の設定がデフォルトとなる一般的な方式とは逆で、未設定のリクエストはフル解像度で生成されます。試行の費用を抑えたい場合は、呼び出しごとにこのフィールドを明示的に設定してください。また、どちらの値も P は大文字です。
- action フィールドを送信しないと、どうなりますか?
- エンドポイントはエラーを返さずに処理を推定します。最初のフレーム画像があれば画像からの動画生成として処理され、なければテキストからの動画生成として処理されます。この推定により、誤って画像を添付しても拒否されず、処理経路が通知なく変わり、アスペクト比やプロンプトの扱いも変化します。そのため、呼び出しごとに action を明示的に設定してください。
- 最初のフレーム画像には、どのような制限がありますか?
- 対応形式は JPEG、JPG、PNG、BMP、WEBP です。ファイルサイズは 10MB 以下、幅と高さはそれぞれ 300px 以上で、アスペクト比は 1:2.5 から 2.5:1 の範囲内である必要があります。使われるのはリストの最初の画像だけです。制限に違反すると、通知なく品質を落として処理されるのではなく、そのまま拒否されるため、送信前に素材を検証してください。
- どの生成時間をリクエストできますか?
- 3秒から15秒まで、整数秒で指定できます。具体的な例として挙げられている値は3 と15です。解像度のデフォルトが 1080P のため、ここでは長さも費用に関する判断になります。各場面を個別に生成し、連続している必要があるショットにだけ、1回の長い生成を使ってください。このエンドポイントでは、1秒未満の短い演出映像は生成できません。
よくある質問
- このページでHappyHorse 1.1を直接使えますか?
- はい。上のクリエイターは実際のOfraiスタジオで、HappyHorse 1.1が初期選択されています。
- 完成した結果はどこに保存されますか?
- ログイン中の生成結果はOfraiライブラリに保存され、ダウンロードや再編集ができます。
- HappyHorse 1.1にはどのようなプロンプトが適していますか?
- 被写体、環境、ビジュアルスタイル、照明、カメラや動きを明確に記述してください。上の例を実用的な出発点として使えます。
- 生成前に例のプロンプトを編集できますか?
- はい。例を読み込んだ後、文章、アスペクト比、参照素材、その他の対応設定を変更できます。
関連モデル
HappyHorse 1.1と同様の制作に対応する他の動画モデルを比較できます。
関連ガイド
ツール
商用利用は選択したモデルとモデル規約に従います。





