Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントでBearer Token認証が必要ですAPIキーの取得:APIキー管理ページからAPIキーを取得してくださいリクエストヘッダーに追加:

モードルーティング

happyhorse-1.1 はテキストから動画 / 画像から動画 / 参照画像から動画の統一エンドポイントです。バックエンドが受信したパラメータに基づいて自動的にモードを判定します。全モードは統一ルール(解像度 × 秒)で課金されます ルーティング優先度(高→低):first_frame_image > image_urls > prompt のみ。 フィールド排他ルール:2 つのメディアフィールド(first_frame_image / image_urls)は相互排他です。排他フィールドを同時指定すると 400 mixed_media_not_allowed が返されます。

リクエストパラメータ

string
必須
動画生成モデル名。happyhorse-1.1 で固定
string
動画内容の説明、最大 2500 文字。特殊トークンを含めることはできません例:"道を歩く少女、映画のような映像"
string
先頭フレーム画像。I2V(画像から動画)をトリガー。URL または base64(data:image/<mime>;base64,<payload>、ゲートウェイが自動的に OSS にアップロード)に対応image_urls と相互排他
先頭フレーム画像の要件:
  • フォーマット:JPEG / JPG / PNG / BMP / WEBP
  • 短辺ピクセル:≥ 300px
  • アスペクト比:1:2.52.5:1
  • ファイルサイズ:≤ 10MB
array<string>
画像配列(R2V モード):1〜9 枚、被写体/スタイル参照として新しいシーンを生成URL または base64 に対応first_frame_image と相互排他
参照画像の要件:
  • フォーマット:JPEG / JPG / PNG / BMP / WEBP
  • 短辺ピクセル:≥ 720p 推奨
  • アスペクト比:短辺/長辺 ≥ 0.4
  • ファイルサイズ:≤ 10MB
  • 枚数:1〜9 枚
string
デフォルト:"1080P"
動画解像度(課金に影響)選択肢:
  • 720P - 標準
  • 1080P - 高解像度(デフォルト)
integer
デフォルト:"5"
動画の長さ(秒、課金に影響)対応範囲:315 の任意の整数デフォルト:5
string
デフォルト:"16:9"
画面のアスペクト比対応フォーマット:
  • 16:9 - 横向きワイド(デフォルト)
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
I2V モードでは無視されます — 出力アスペクト比は入力メディア(先頭フレーム画像)により自動決定されます
boolean
デフォルト:"false"
生成された動画にウォーターマークを追加するかどうか
  • true:ウォーターマークを追加
  • false:ウォーターマークを追加しない(デフォルト)
integer
生成内容のランダム性を制御するシード範囲:[0, 2147483647]。省略時はランダム
  • 同一リクエストで異なるseed値を受け取ると(seedを指定しない場合など)、異なる結果が生成されます
  • 同一リクエストで同じseed値を受け取ると、類似した結果が生成されますが、完全一致は保証されません

レスポンス

integer
レスポンスステータスコード。成功時は 200
array
レスポンスデータ配列

使用例

例 1:テキストから動画 T2V(最小リクエスト)

例 2:テキストから動画 T2V(フルパラメータ)

例 3:画像から動画 I2V(first_frame_image)

例 4:参照画像から動画 R2V(複数参照画像)

例 5:720P で料金節約

モード選択ガイド

使用上のヒント

  1. 統一エンドポイントの動作:渡されたフィールドでモードが決まります。2 つのメディアフィールド(first_frame_image / image_urls)は相互排他です
  2. size は T2V/R2V のみ有効:I2V モードでは size が無視され、出力アスペクト比は入力メディアにより決定されます
  3. 長さ:5〜10 秒が最適。短すぎると動きが不連続、長すぎると上流処理時間が大幅に増加します
  4. 先頭フレーム画像の品質:鮮明、構図が明確、被写体が中央 — I2V の効果が大きく向上します
  5. プロンプト記述:動き / カメラワーク / 雰囲気を記述(例「ゆっくりプッシュイン、映画のような、暖色」)すると、静的なシーン記述のみより良い結果になります
タスク結果の取得動画生成は非同期タスクで、送信時に task_id が返されます。タスクステータス取得 エンドポイントで生成進捗と結果を取得してください。