Hailuo（MiniMax）シリーズ

MiniMax の Hailuo（海螺）動画生成モデルで、全 2 モデルです。OfoxAI の動画エンドポイント POST /v1/videos で呼び出します。タスクは非同期で実行され、タスクを作成するとタスク ID が返り、その ID で結果を照会します。

モデルの選び方

ポイント2K 出力が必要なら Hailuo 3、480p が必要なら Hailuo 3 Max を選びます。どちらも 720p と 1080p には対応していません。

モデル	解像度（デフォルト）	長さ	アスペクト比
Hailuo 3	`768p` `2k`（`768p`）	4–15 秒	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `adaptive`
Hailuo 3 Max	`480p` `768p`（`768p`）	5–15 秒	同上

2 モデルとも、テキストから動画、画像から動画、動画参照に対応し、同期した音声トラックを生成できます（generate_audio のデフォルトは true）。adaptive は入力画像の比率をそのまま使うことを表します。

モデル ID（そのままコピーしてください）

Hailuo 3minimax/hailuo-3768p、2K

Hailuo 3 Maxminimax/hailuo-3-max480p、768p、最短 5 秒

上の表は Models API が返す video_attributes と一致しています。モデルの機能が変更された場合は API の返り値が優先されます。秒単位で課金され、実際の料金はタスク結果の usage.video_cost に従います。価格はモデルページを参照してください。

呼び出し例

以下の例はタスク作成のリクエストのみを示しています。作成後にステータスを照会し、結果をダウンロードするまでの流れは Video API · クイックスタートを参照してください。

テキストから動画

prompt だけを渡します。

Terminal


curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "シネマスコープのショット：砂漠の道路を走るクラシックカーが夕日に向かう",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'

画像から動画

frame_images に first_frame を 1 枚渡すと、その画像を最初のフレームとする動画が生成されます。

Terminal


curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "画面の人物が振り返り、遠くへ歩いていく",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

動画参照

input_references に動画を 1 本渡して参照にします。動画を入力にした場合、課金秒数に入力動画の長さが含まれる場合があります。

Terminal


curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "カメラワークはそのままに、水墨画アニメのスタイルに変える",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

frame_images と input_references は同時に渡せません。両方を渡すと 400 references_conflict が返ります。
音声トラックが不要な場合は "generate_audio": false を渡します。
フィールド構造の詳しい説明は動画タスクを作成を参照してください。

解像度の指定方法

Hailuo の解像度 tier はほかのシリーズと異なり、768p と 2k（小文字の k）です。ほかのシリーズでよく使う 720p や 1080p を渡すと 400 が返ります。

よくあるエラー

ポイントパラメータの検証エラーは作成時に返され、タスクは作成されず、料金も発生しません。エラーメッセージには許可される値が示されます。

HTTP · code	エラーメッセージ原文	原因	対処方法
400 `unsupported_parameter`	`resolution "1080p" not supported; allowed: [768p 2k]`	Hailuo は 1080p に非対応	Hailuo 3 では `768p` または `2k` を使う
400 `unsupported_parameter`	`duration 4 out of range [5, 15]`	Hailuo 3 Max の最短は 5 秒	5 秒以上に変更するか、Hailuo 3 に切り替える
400 `references_conflict`	`frame_images and input_references are mutually exclusive`	2 種類の素材フィールドを同時に渡した	どちらか一方のみを使用する
404 `model_not_found`	`model not found`	モデル ID のスペルミス	このページからモデル ID をコピーする

エラーコードの全体は Video API エラーコードを参照してください。

公式ドキュメント

よくある質問

Hailuo 3 は 1080p に対応していますか？

対応していません。Hailuo 3 の解像度は 768p と 2k、Hailuo 3 Max は 480p と 768p です。720p や 1080p を渡すと 400 resolution not supported が返ります。

Hailuo 3 Max で duration 4 out of range [5, 15] エラーが出るのはなぜですか？

Hailuo 3 Max は 1 タスクあたり最短 5 秒、最長 15 秒です。4 秒の動画が必要な場合は Hailuo 3 を使ってください。

Hailuo の動画は 21:9 に対応していますか？

対応しています。Hailuo 3 と Hailuo 3 Max はどちらも 21:9、16:9、4:3、1:1、3:4、9:16、adaptive に対応しています。