Skip to main content
POST

認証

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

モードルーティング

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

リクエストパラメータ

string
必須
動画生成モデル名。happyhorse-1.0 で固定
string
動画内容の説明、最大 2500 文字。特殊トークンを含めることはできません
  • T2V / R2V / EDIT モード:必須
  • I2V モード:任意だが、カメラワークやアクションの指示のため推奨
例:"道を歩く少女、映画のような映像"
string
先頭フレーム画像。I2V(画像から動画)をトリガー。URL または base64(data:image/<mime>;base64,<payload>、ゲートウェイが自動的に OSS にアップロード)に対応image_urls / video_url と相互排他
先頭フレーム画像の要件:
  • フォーマット:JPEG / JPG / PNG / BMP / WEBP
  • 短辺ピクセル:≥ 300px
  • アスペクト比:1:2.52.5:1
  • ファイルサイズ:≤ 10MB
array<string>
画像配列:
  • R2V モードimage_urls のみ指定):1〜9 枚、被写体/スタイル参照として新しいシーンを生成
  • EDIT モードvideo_url と併せて指定):0〜5 枚、スタイル参照画像として使用
URL または base64 に対応first_frame_image と相互排他、video_url とは併用可能
参照画像の要件:
  • フォーマット:JPEG / JPG / PNG / BMP / WEBP
  • 短辺ピクセル:≥ 720p 推奨
  • アスペクト比:短辺/長辺 ≥ 0.4
  • ファイルサイズ:≤ 10MB
  • 枚数:R2V は 1〜9 枚必須、EDIT は最大 5 枚
string
ソース動画 URL。EDIT(動画編集)をトリガー。base64 は非対応、HTTP/HTTPS 直リンクを指定してくださいfirst_frame_image と相互排他、image_urls(≤ 5 枚)とは併用可能
ソース動画の要件:
  • 長さ:3〜60 秒(> 15s の場合、上流が 0 から 15s まで自動切り出し)
  • 解像度:最小 480p、短辺 ≥ 360
  • アスペクト比:1:88:1
  • フォーマット:MP4 / MOV(H.264 推奨)
  • フレームレート:> 8 fps
  • ファイルサイズ:≤ 100MB
EDIT モードでは生成動画の長さがソース動画と同一になります(ソースが 15 秒を超える場合は切り出された 15 秒で計算)。このとき duration パラメータは無効です。出力の長さを制御したい場合は、アップロード前にソース動画を目的の長さにトリミングしてください。
string
デフォルト:"auto"
音声設定。EDIT モードのみ有効video_url の指定が必須)選択肢:
  • auto - 自動生成音声(デフォルト)
  • origin - 元動画の音声トラックを保持
EDIT モード以外で本フィールドを指定すると 400 audio_setting_only_for_edit が返されます
string
デフォルト:"1080P"
動画解像度(課金に影響)選択肢:
  • 720P - 標準
  • 1080P - 高解像度(デフォルト)
integer
デフォルト:"5"
動画の長さ(秒、課金に影響)対応範囲:315 の任意の整数デフォルト:5
EDIT モード(video_url を指定)では本パラメータは無効です:生成動画の長さはソース動画と同一になります(ソースが 15 秒を超える場合は切り出された 15 秒で課金)。出力の長さを制御したい場合は、事前にソース動画をトリミングしてください。
string
デフォルト:"16:9"
画面のアスペクト比対応フォーマット:
  • 16:9 - 横向きワイド(デフォルト)
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
I2V / EDIT モードでは無視されます — 出力アスペクト比は入力メディア(先頭フレーム画像 / ソース動画)により自動決定されます
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:動画編集 EDIT(元音声保持 + スタイル参照)

例 6:720P で料金節約

モード選択ガイド

使用上のヒント

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